К основному содержанию
скилл CX Codex

payment-ppp-pos — скилл для Claude Code: что делает и как установить

Скилл payment-ppp-pos помогает разрабатывать и отлаживать коннекторы платежей POS через VTEX Payment Provider Protocol для приложения VTEX Sales App.

лицензия не указана 252 установок ★ 47 обновлён 2026-10-14

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add vtex/skills --skill payment-ppp-pos -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/payment-ppp-pos/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/payment-ppp-pos/

По шагам, с командами для каждой платформы: Как установить скилл в 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 до ответа терминала.

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
Kash — POS, Invoicing, CRM & Webshop paracetamol951 Kash — POS, Invoicing, CRM & Webshop — MCP-сервер для Claude Code, который подключает магазин к ИИ-ассистенту для работы с заказами, клиентами и отчётами по продажам в диалоге. CX Codex +1 2 880установок shopify-pos-ui официальный Shopify Скилл shopify-pos-ui помогает писать интерфейсы для Shopify POS на Preact и разворачивать расширения через консоль. Пригодится при разработке экранов кассы и карточек клиентов. CX Codex GP ChatGPT +1 2установок sumup sumup Подключает платёжные сценарии SumUp: онлайн-оплату через виджет и SDK, а также работу с POS-терминалами на iOS и Android. ★ 7звёзд репо payment-testing kindlmann Скилл payment-testing для Claude Code помогает настроить сквозные проверки списаний, сценариев 3DS и вебхуков в песочницах Stripe, Adyen и PayPal с помощью Playwright. CX Codex +1 1 300установок payment-gateway-integration aj-geddes Скилл payment-gateway-integration для Claude Code, который подключает Stripe, PayPal и Square к бэкенду: платежи, подписки, вебхуки, возвраты. Работает и в Codex, Cursor, Copilot, Gemini CLI, OpenCode. CX Codex +1 531установок payment-integration mrgoonie Скилл payment-integration для Claude Code помогает подключать платёжные сервисы, настраивать оформление заказа и обработку вебхуков. Вызывается при работе с подписками, QR-платежами и заказами через нескольких провайдеров. CX Codex +1 361установок

Из того же набора46

Весь набор →
headless-caching-strategy Скилл headless-caching-strategy задаёт правила кэширования для headless-витрин на VTEX. Помогает настроить CDN, BFF и стратегию stale-while-revalidate без утечки личных данных. CX Codex +1 1 100установок headless-intelligent-search Скилл headless-intelligent-search помогает подключить поиск VTEX Intelligent Search к headless-магазину: от подсказок и фильтров до событий аналитики. Пригодится при разработке собственной витрины. CX Codex +1 1 100установок payment-idempotency Скилл payment-idempotency для Claude Code и ещё пяти платформ, который задаёт правила идемпотентности в коде платёжного коннектора. Подключается при обработке повторных запросов от шлюза VTEX, чтобы не снимать деньги с клиента дважды. CX Codex +1 1 100установок sales-app-extensibility Скилл sales-app-extensibility помогает разрабатывать, настраивать и собирать расширения для VTEX Sales App. Проводит через семь этапов от проверки структуры проекта до деплоя. CX Codex +1 927установок vtex-io-storefront-theme-versioning Скилл vtex-io-storefront-theme-versioning инструктирует агента по обновлению, публикации и откату тем оформления в VTEX IO без потери контента из Site Editor при смене мажорной версии. CX Codex +1 861установок vtex-io-rootpath Скилл vtex-io-rootpath для VTEX IO-приложений в мультибиблиотечных магазинах: подсказывает, как строить URL с учётом префикса привязки. Пригодится при отладке 404 и битых ссылок. CX Codex +1 817установок vtex-io-rbac Скилл vtex-io-rbac для Claude Code и других агентов, который подсказывает, как ограничить доступ к роутам и ресурсам VTEX IO. Разбирает ролевые политики в policies.json, ресурсные правила в service.json и GraphQL-директиву @auth. CX Codex +1 816установок masterdata-storage-strategy Скилл masterdata-storage-strategy помогает выбрать хранилище данных в экосистеме VTEX и составить JSON-схему для Master Data с правильными индексами, кешем и правами доступа. CX Codex +1 797установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой