Payment Orchestration Overview

PayPal's Payment Orchestration is a layer that lets merchants connect to multiple PSPs or acquirers and value-added services through a single integration, so they can route and manage transactions without building and maintaining many direct connections. It improves authorization performance, adds redundancy, supports geographical expansion, and simplifies ecosystem management.

Merchants can use their existing Braintree integration to enable orchestration with no changes to their client-side tokenization or SDK code, while gaining the ability to reach markets and card networks and build relationships.

Payment orchestration provides the following benefits:

  • Scale globally without re-integrating. Merchants can activate additional PSPs and local acquiring in high-growth regions using their existing Braintree SDK or GraphQL integration — no new client-side code and no new checkout flow.
  • Improve authorization rates with local acquiring. Cross-border traffic declines more often due to issuer risk rules and currency friction. Routing through local acquirers like dLocal or EBANX can materially lift approvals in markets like Brazil, Mexico, and Nigeria, recovering revenue that would otherwise be lost.
  • Unlock local card brands global networks don't reach. Orchestration connectors support region-specific schemes — such as Elo/Hipercard, Verve/Afrigo, and Naranja/Cabal/RedCompra — expanding reach to cardholders who can't transact on Visa or Mastercard alone.
  • Add redundancy and reduce downtime risk. A multi-PSP setup provides a failover path when one provider has degraded performance or an outage, protecting conversion during incidents.
  • Recover revenue from false declines automatically. Integrations like FlexFactor route failed transactions through a real-time decision engine to identify false declines and reattempt via an alternative path, without merchants building their own retry logic.
  • Reduce tech debt and avoid PSP lock-in over time. Orchestration centralizes connectivity and makes it easier to add, swap, or expand PSP relationships as needs evolve — across auth, cost, latency, and geo coverage — without rebuilding the payments stack.

Important: You must perform all transaction operations (auth, capture, void, and refund) through Braintree. Calling a connector directly, without going through Braintree, will cause reconciliation errors and synchronization issues.

Available connectorsAnchorIcon

The following connectors are available. You can enable each connector through your Braintree account, and they require no client-side code changes. For more information, see the guide for each connector that you use.

Adyen

Braintree's partnership with Adyen provides global acquiring reach through Adyen's enterprise infrastructure with full wallet and 3DS support.

Adyen integration guide

dLocal

Braintree's partnership with dLocal enables merchants to process transactions through local acquiring across 23 markets in Latin America and Southeast Asia, including Brazil, Mexico, Argentina, Indonesia, and Japan.

Key capabilities: Installments (up to 48), network tokens, 3DS (required in Indonesia, Japan, and for debit in Brazil), local card brands (Elo, Naranja, Cabal, Carnet, and more).

dLocal integration guide

EBANX

Braintree's partnership with EBANX covers 13 markets, with strong Latin America (LatAm) coverage and additional reach into Africa, including Nigeria, Egypt, and South Africa.

Key capabilities: Apple Pay and Google Pay (in progress), network tokens (Brazil only), 3DS conditional by market, prepaid card support, local card brands including Elo and Verve.

EBANX integration guide

Fat Zebra

Braintree's partnership with Fat Zebra enables direct acquiring in Australia and New Zealand with support for digital wallets and local payment rails.

Key capabilities: Apple Pay, Google Pay, EFTPOS (Australia only — requires Fat Zebra enablement), network tokens, 3DS optional, partial capture supported.

Fat Zebra integration guide

FlexFactor

FlexFactor is a false-decline recovery engine. If a transaction fails on PayPal Enterprise, FlexFactor's real-time decision engine evaluates it and can recover revenue by routing through an alternative acquiring path.

Key capabilities: Dual-step transactions only, 3DS supported, dispute handling managed by FlexFactor. Partial refunds are capped at 60% of the original order value.

FlexFactor integration guide

Flutterwave

Braintree's partnership with Flutterwave enables card-not-present acquiring across Africa and emerging markets, supporting 22 currencies. This integration uses a non-public card-direct API distinct from Flutterwave's public-facing products.

Key capabilities: Verve and Afrigo card brands in addition to Mastercard and Visa, dual-step transactions, partial and multiple refunds. Note: 3DS, network tokens, and AVS are not supported in this integration.

Flutterwave integration guide

Stripe

Braintree's partnership with Stripe enables processing in the United States only. It provides access to Stripe's acquiring infrastructure with broad card brand coverage.

Key capabilities: Network tokens (Braintree-managed and BYOT), 3D Secure (3DS), JCB and UnionPay support, dynamic descriptors (22-character limit).

Note: $0 verification is not supported. Card validation requires a minimum charge of $0.50.

Stripe integration guide

Next stepsAnchorIcon

To get started, work with your Braintree account manager (AM) or technical account manager (TAM) to identify which connectors are appropriate for your markets.