payment-async-flow — скилл для Claude Code: асинхронные платежи VTEX

Что делает payment-async-flow

Скилл включается, когда коннектор принимает платёж, который не закрывается сразу: Boleto Bancário, Pix, банковский перевод, редирект на сторонний сайт. В таких случаях Create Payment обязан вернуть status: "undefined", а финальный статус приходит позже через callbackUrl. Если вернуть "approved" раньше времени, заказ уйдёт в сборку без денег; если "denied" — отменится платёж, который клиент ещё может завершить.

Внутри разобраны два режима callbackUrl: без VTEX IO это эндпоинт уведомления, куда статус отправляют с заголовками X-VTEX-API-AppKey и X-VTEX-API-AppToken; с VTEX IO — эндпоинт повтора, POST без тела заставляет шлюз заново вызвать authorize(). Параметр X-VTEX-signature в callbackUrl сохраняют как есть, не вырезают и не правят. Отдельно расписано, как считать delayToCancel: для Pix от 900 до 3600 секунд по времени жизни QR-кода, для Boleto — по сроку оплаты счёта.

Есть ограничение, о которое легко споткнуться: inboundRequestsUrl работает только server-to-server через POST и не поддерживает GET-редирект из браузера. Для PayPal и 3DS придётся поднимать собственный публичный маршрут. Скилл не покрывает контракты PPP, идемпотентность paymentId/requestId, PCI и терминальные платежи — для них в наборе есть соседние скиллы.