payment-provider-protocol — скилл для Claude Code: настройка
Помогает создавать и отлаживать коннекторы к платёжному шлюзу VTEX по спецификации PPP. Содержит правила для всех девяти эндпоинтов и прохождения тестов.
npx skills add vtex/skills --skill payment-provider-protocol -a claude-codeЧто делает payment-provider-protocol
Скилл направляет агента при разработке коннекторов между платёжными провайдерами и шлюзом VTEX Gateway. Он следит за реализацией шести обязательных маршрутов: GET /manifest, POST /payments, отмены, списания, возвраты и inbound-request. Три дополнительных метода конфигурации авторизации он оставляет опциональными.
Коннектор обязан отвечать по HTTPS через порт 443 с поддержкой TLS 1.2. Для успешной омологации сервер должен укладываться в 5 секунд на ответ, а в продакшене лимит составляет 20 секунд. Без любого из обязательных полей ответа вроде delayToAutoSettle или authorizationId шлюз сразу сломается на этапе десериализации.
Шлюз сам инициирует вызовы. Для работы с картами требуется сертификат PCI-DSS либо Secure Proxy. Идемпотентность и асинхронные уведомления вынесены в другие скиллы автора.
Какие задачи решает
- реализовать обязательные эндпоинты протокола PPP для шлюза VTEX
- подготовить коннектор к прохождению тестов омологации
- настроить схему ответа
CreatePaymentс тайм-аутами автосеттла - объявить поддерживаемые методы оплаты в маршруте
/manifest
Примеры запросов агенту
- Напиши Express-роутер со всеми шестью обязательными эндпоинтами для VTEX PPP
- Проверь ответ метода
/payments, чтобы шлюз VTEX не падал при десериализации - Сформируй манифест
/manifestс поддержкой сплит-платежей для нашего коннектора
Как установить payment-provider-protocol
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill payment-provider-protocol -a claude-code2Вручную: положить файлы
~/.claude/skills/payment-provider-protocol/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/payment-provider-protocol/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill payment-provider-protocol -a codex2Вручную: положить файлы
.agents/skills/payment-provider-protocol/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill payment-provider-protocol -a cursor2Вручную: положить файлы
.cursor/skills/payment-provider-protocol/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills payment-provider-protocol2Вручную: положить файлы
.github/skills/payment-provider-protocol/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill payment-provider-protocol -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/payment-provider-protocolВручную: положить файлы
.devin/skills/payment-provider-protocol/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill payment-provider-protocol -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о payment-provider-protocol
Как установить payment-provider-protocol в Claude Code?
Выполните команду npx skills add vtex/skills --skill payment-provider-protocol -a claude-code. Правила будут записаны в файл ~/.claude/skills/payment-provider-protocol/SKILL.md.
Что проверяет скилл payment-provider-protocol?
Он следит за наличием шести обязательных роутов коннектора, правильной структурой ответов шлюзу и соблюдением тайм-аутов в 5 секунд при тестировании.
Подходит ли этот скилл для настройки идемпотентности платежей?
Нет, обработка повторных запросов и защита от дублей вынесены в отдельный скилл payment-idempotency.
