# shopify-payments-apps

Помогает писать GraphQL-запросы и мутации к Payments Apps API в Shopify. Полезен при работе с платежами, возвратами и сессиями оплаты.

- скилл · `type=skill` · Codex, ChatGPT · ★ 7604
- Автор: Shopify · официальный репозиторий OpenAI
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/openai/plugins/tree/HEAD/plugins/shopify/skills/shopify-payments-apps/SKILL.md
- Обновлён: 2026-10-08
- HTML: https://affpapa.org/nevibecode/skills/shopify-payments-apps

## Что делает

Скилл ведёт агента по работе с Payments Apps API: перед каждым ответом он ищет нужную операцию в документации, пишет код по найденным примерам, а затем прогоняет его через валидатор. Поиск идёт по имени операции или компонента, а не по полной формулировке задачи. Так агент не опирается на свои тренировочные знания о GraphQL-схеме.

Внутри два скрипта: `scripts/search_docs.mjs` для поиска по векторному хранилищу документации и `scripts/validate.mjs` для проверки сгенерированного кода. Валидатор принимает флаги с именем модели, клиента и версией, а также `--artifact-id` и `--revision`. Если проверка не прошла, агент ищет тип ошибки, правит код и запускает валидацию снова, но не больше трёх раз.

Для работы нужен Node.js. Оба скрипта отправляют данные в Shopify на `shopify.dev/mcp/usage`: поисковые запросы, результат валидации, имя скилла, идентификаторы модели и клиента. Отключить это можно переменной окружения `OPT_OUT_INSTRUMENTATION=true` — без неё запросы уходят наружу по умолчанию.

## Установка

### Codex (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill shopify-payments-apps -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/shopify-payments-apps/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Claude Code

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill shopify-payments-apps -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/shopify-payments-apps/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/shopify-payments-apps/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/skills/shopify-payments-apps/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install openai/plugins shopify-payments-apps
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/shopify-payments-apps/SKILL.md`

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/shopify/skills/shopify-payments-apps
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/shopify-payments-apps/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/openai/plugins/tree/HEAD/plugins/shopify/skills/shopify-payments-apps/SKILL.md

## Когда брать
- написать GraphQL-мутацию для создания платёжной сессии
- разобраться с авторизацией, capture и settlement при оплате
- свести возврат или void с исходной транзакцией
- добавить обработку отклонённых платежей и ошибок сети
- подключить 3D Secure и вебхуки о подтверждении оплаты

## Примеры запросов агенту
- Напиши мутацию paymentSessionPending для Payments Apps API и прогони её через валидатор
- Сгенерируй GraphQL-запрос для возврата по транзакции, сначала поищи пример в документации
- Проверь мой код через `scripts/validate.mjs` и исправь ошибки, если валидация не прошла

## Похожие
- [shopify-apps](https://affpapa.org/nevibecode/skills/sickn33-shopify-apps.md) — скилл · 1000 установок
- [shopify-products](https://affpapa.org/nevibecode/skills/shopify-products.md) — скилл · 1400 установок
- [shopify-setup](https://affpapa.org/nevibecode/skills/shopify-setup.md) — скилл · 1200 установок
- [shopify-expert](https://affpapa.org/nevibecode/skills/shopify-expert.md) — скилл · 5000 установок
- [shopify](https://affpapa.org/nevibecode/skills/shopify.md) — скилл · 4800 установок
- [shopify-development](https://affpapa.org/nevibecode/skills/shopify-development.md) — скилл · 1900 установок

Из того же набора: [openai/plugins](https://affpapa.org/nevibecode/by/openai/plugins.md) — 528 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md