payment-ppp-pos — скилл для Claude Code: что делает и как установить
Скилл payment-ppp-pos помогает разрабатывать и отлаживать коннекторы платежей POS через VTEX Payment Provider Protocol для приложения VTEX Sales App.
лицензия не указана 252 установок ★ 47 обновлён 2026-10-14
npx skills add vtex/skills --skill payment-ppp-pos -a claude-codeЧто делает payment-ppp-pos
Скилл содержит правила для интеграции физических платежных терминалов с протоколом VTEX PPP. Он настраивает методы манифеста Venda Direta Credito и Venda Direta Debito, работу двухэтапного Payment App challenge через vtex.terminal-connector-app и vtex.challenge-wait-for-confirmation, а также парсинг обратных вызовов с данными карты.
В основе реализации лежит конечный автомат метода authorize(). Шлюз не получает данные карты покупателя при POS-транзакциях, поэтому блок card приходит как null, и Secure Proxy вызывать не требуется. Для статуса возвращается асинхронный undefined, пока терминал не подтвердит транзакцию.
Без VTEX IO итоговый статус отправляется POST-запросом в callbackUrl, а внутри VTEX IO тот же URL служит триггером повтора и вызывается с пустым телом.
Какие задачи решает
- настроить обработку оплат через физические терминалы в VTEX Sales App
- реализовать методы Venda Direta Credito и Venda Direta Debito
- сконфигурировать двухэтапный сценарий Payment App challenge
- собрать финальный ответ со статусом и полями cardBrand, firstDigits и lastDigits
Примеры запросов агенту
- Помоги реализовать метод authorize для POS коннектора VTEX на базе Payment Provider Framework
- Как обработать Venda Direta Debito и настроить вызов vtex.terminal-connector-app?
- Исправь логику опроса callbackUrl для терминала в среде VTEX IO
Как установить payment-ppp-pos
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill payment-ppp-pos -a claude-code2Вручную: положить файлы
~/.claude/skills/payment-ppp-pos/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/payment-ppp-pos/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill payment-ppp-pos -a codex2Вручную: положить файлы
.agents/skills/payment-ppp-pos/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill payment-ppp-pos -a cursor2Вручную: положить файлы
.cursor/skills/payment-ppp-pos/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills skills/payment-ppp-pos2Вручную: положить файлы
.github/skills/payment-ppp-pos/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill payment-ppp-pos -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/payment-ppp-posВручную: положить файлы
.devin/skills/payment-ppp-pos/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill payment-ppp-pos -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о payment-ppp-pos
Как установить payment-ppp-pos в Claude Code?
Выполните команду npx skills add vtex/skills --skill payment-ppp-pos -a claude-code. Файл скилла загрузится по пути ~/.claude/skills/payment-ppp-pos/SKILL.md.
Что делает этот скилл?
Он задаёт правила генерации кода и отладки для коннекторов VTEX PPP, работающих с физическими POS-терминалами через приложение Sales App.
Почему объект card приходит как null в запросе Create Payment?
При POS-оплате шлюз VTEX не принимает данные карты покупателя напрямую, поэтому вызывать Secure Proxy не требуется, а статус платежа остаётся undefined до ответа терминала.