AIKraft/AI/Войти
AIKraft/Skills/Асинхронный платёжный процесс

Асинхронный платёжный процесс

Apply when implementing asynchronous payment methods (Boleto, Pix, bank redirects) or working with callback URLs in payment connector code. Covers undefined status response, callbackUrl notification, X-VTEX-signature validation, sync vs async handling, correct delayToCancel configuration for each async method, and redirect-based flows where inboundRequestsUrl does not support browser GET redirects

vtex official Разработка

Что делает навык

Навык описывает реализацию асинхронных платёжных процессов, включая методы оплаты (Boleto, Pix, банковские переводы) и редиректные потоки аутентификации. Он регулирует обработку статусов undefined, работу с callbackUrl, валидацию подписей и конфигурацию задержек отмены.

Когда применять

  • Реализация платёжного коннектора для Boleto Bancário, Pix или банковских переводов.
  • Обработка уведомлений через callbackUrl и управление циклами автоматических повторных попыток (retry) со статусом undefined в течение 7 дней.
  • Настройка корректного значения delayToCancel для каждого асинхронного метода оплаты.
  • Реализация потоков аутентификации на основе редиректа (например, PayPal, 3DS), где пользователь покидает checkout VTEX.
  • Обработка случаев, когда inboundRequestsUrl не поддерживает браузерные GET-редиректы.

Как работает

  1. Определить, что метод оплаты не возвращает финальный статус синхронно, и подготовить коннектор к асинхронной обработке.
  2. Настроить валидацию заголовка X-VTEX-signature при получении уведомлений от acquirer.
  3. Обеспечить корректную обработку callbackUrl, включая логику повторных попыток (retry flows).
  4. Установить параметр delayToCancel для каждого асинхронного метода в соответствии с требованиями.
  5. Реализовать редиректные потоки (redirect-based flows), учитывая ограничения inboundRequestsUrl на поддержку браузерных GET-редиректов.
  6. Управлять 7-дневным циклом автоматических повторных попыток Gateway для платежей со статусом undefined.

Примеры запросов агенту

Как реализовать платёжный коннектор для Pix с поддержкой callbackUrl?
Настрой валидацию X-VTEX-signature для уведомлений о статусе платежа.
Как обработать редирект после оплаты через PayPal, если inboundRequestsUrl не поддерживает GET-запросы?

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «payment-async-flow» из репозитория: # https://github.com/vtex/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r payment-async-flow/ ~/.claude/skills/payment-async-flow/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.