payment-provider-protocol

To implement a VTEX Payment Provider Protocol connector that passes homologation, follow a production-ready blueprint enforcing endpoint contracts, manifest accuracy, TLS requirements, and performance constraints across all 9 PPP endpoints and configuration flows.

The VTEX Payment Provider Protocol (PPP) is a middleware standard for integrating external payment service providers with the VTEX Payment Gateway. You need it when building or debugging a connector to support merchant onboarding and live payment flows.

Full PPP compliance requires implementing Manifest, Create Payment, Cancel, Capture/Settle, Refund, and Inbound Request endpoints, plus optional auth token, provider redirect, and credentials endpoints, enforcing correct response shapes and security constraints.

VTEX payment connectors fail homologation due to incorrect response shapes, manifest inaccuracies, missing TLS requirements, or performance constraint violations. Debugging requires verifying endpoint decision rules and configuration flows against the PPP contract blueprint.

Yes, you can use this PPP blueprint to debug an existing VTEX payment provider integration. It guides endpoint decision rules, configuration flows, and response shape enforcement for reliable, compliant payment integrations across VTEX platforms.