Asynchronous Payment Flows & Callbacks

When this skill applies

Use this skill when:

• Implementing a payment connector that supports Boleto Bancário, Pix, bank transfers, or redirect-based flows
• Working with any payment method where the acquirer does not return a final status synchronously
• Handling callbackUrl notification or retry flows
• Managing the Gateway's 7-day automatic retry cycle for undefined status payments
• Implementing redirect-based authentication flows (e.g., PayPal, 3DS redirects) where the user leaves the VTEX checkout and returns after completing payment on an external site

Do not use this skill for:

• PPP endpoint contracts and response shapes — use payment-provider-protocol
• paymentId/requestId idempotency and state machine logic — use payment-idempotency
• PCI compliance and Secure Proxy card handling — use payment-pci-security

Decision rules