payment-provider-framework

To build a VTEX IO payment connector, wire PaymentProvider and PaymentProviderService inside an IO app, configure manifest.json and configuration.json with real methods, and implement PPP routes for transaction processing.

The Payment Provider Framework is a VTEX IO standard that enables apps to expose PPP routes for payment processing, ensuring correct integration between custom connectors and the platform's checkout flow.

Configuring the Secure Proxy involves using the Secure External Client with allowlisted destinations in your VTEX IO app, ensuring outbound payment requests are routed securely through the Payment Provider Framework.

Yes, the paymentProvider builder is a mandatory prerequisite. You must declare it in your manifest.json to properly wire the PaymentProvider and PaymentProviderService interfaces for your connector.

The configuration.json must define real, supported payment methods and connector settings. A valid configuration file is a strict prerequisite before implementing PPP routes and testing the integration.

Testing and homologating a VTEX IO payment connector requires following the guided workflow to validate PPP routes, Secure Proxy configurations, and configuration.json methods before production deployment.