Payment Provider Protocol

This walks you through implementing all nine endpoints required for a VTEX Payment Provider Protocol connector: the six payment flow endpoints (Manifest, Create Payment, Cancel, Capture, Refund, Inbound Request) plus the three optional configuration endpoints for merchant onboarding. The constraints are strict because you're building middleware that sits between the VTEX Payment Gateway and your payment service provider, and missing fields or wrong response shapes will fail homologation tests. Use this when you're building a new payment connector from scratch or debugging why your existing connector isn't passing the VTEX Payment Provider Test Suite. It enforces the exact HTTP status codes, response structures, and manifest declarations the Gateway expects, so you don't waste time chasing deserialization errors in production.