Mercado Pago Crossborder

Mercado Pago Crossborder, also known as Cross Border Payments (CBP), is a Mercado Pago Global Selling solution for merchants that do not have a local entity in Latin America. Customers pay in their local currency, while the merchant receives settlement in USD.

DEUNA integrates with Mercado Pago Crossborder through the Mercado Pago Orders API.

Review supported capabilitiesPerguntar à Athia sobre isto#

Mercado Pago Crossborder supports the following operations through DEUNA:

• Purchase with automatic capture
• Authorization
• Full capture
• Cancel (void)
• Full and partial refunds
• Installments in supported countries
• Webhook notifications and payment-status polling

Partial capture is not supported. An authorized payment must be captured for the full authorized amount.

Supported payment methods

• Visa credit and debit cards
• Mastercard credit and debit cards

Active countries, currencies, and operations

Use the interactive catalog to confirm the currencies and operations available for each country before configuring the connection.

The connection form supports the following local currencies:

• Argentina: ARS
• Brazil: BRL
• Chile: CLP
• Colombia: COP
• Mexico: MXN
• Peru: PEN

Availability depends on your Mercado Pago account and country-specific credentials.

Understand FX modesPerguntar à Athia sobre isto#

When you create the connection, select how Mercado Pago calculates the USD settlement amount:

• One Amount: Leave Activate Two Amounts unchecked.
• Two Amounts: Select Activate Two Amounts.

Mercado Pago provides the exchange rate in both modes. The USD amount is gross; Mercado Pago deducts its fees, taxes, and withholdings before payout.

Before you connectPerguntar à Athia sobre isto#

Make sure that you have:

• Access to Connections in DEUNA Admin.
• An active Mercado Pago Crossborder account for the country you want to process.
• The country-specific Mercado Pago public key, private key, merchant ID, merchant password, state ID, and platform ID.
• A separate credential set for every country where you process payments.

Connect Mercado Pago CrossborderPerguntar à Athia sobre isto#

1. Log in to DEUNA Admin.
2. Select Connections.
3. Search for Mercado Pago Crossborder and select Connect.

4. Complete the configuration form:
   • Name: Enter a name that identifies this credential configuration.
   • Country: Select the country where payments are processed.
   • Currency: Select the local currency charged to the payer: ARS, BRL, CLP, COP, MXN, or PEN.
   • Public API Key: Enter your Mercado Pago public key.
   • Private API Key: Enter your Mercado Pago private key.
   • Merchant ID: Enter your Mercado Pago merchant identifier.
   • Merchant Password: Enter the password associated with the merchant ID.
   • State ID: Enter the applicable ISO 3166-2 state code.
   • Platform ID: Enter the platform identifier assigned by Mercado Pago.
   • Activate Two Amounts: Select this option to use Two Amounts FX mode. Leave it unchecked to use One Amount mode.
   • Destination Currency: Confirm USD as the settlement currency.
   • Operations: Select Purchase or Authorization.
5. Select Connect.

After DEUNA confirms the connection, verify that Mercado Pago Crossborder appears in the Active Connections tab.

Add the connection to your payment strategyPerguntar à Athia sobre isto#

After the connection is active, add it to the payment strategy that should route eligible Crossborder transactions.

Confirm that the strategy country, currency, and operation match the connection before activating it.

Meet transaction requirementsPerguntar à Athia sobre isto#

Send the device fingerprint

Mercado Pago requires device-fingerprint data for Crossborder transactions. Follow the device fingerprint integration guide before processing payments.

Include payer identification

Provide the payer's document type and document number when the payment is not tokenized. Payer identification is always required in Brazil.

Consider limitationsPerguntar à Athia sobre isto#

Mercado Pago Crossborder does not support:

• 3-D Secure (3DS)
• Partial capture
• Installments in Argentina, Chile, or Colombia
• American Express in Argentina or Mexico
• Stored cards or recurring payments
• Internationally issued cards in Brazil

For the Authorization and Capture flow, capture the full authorized amount. Do not enable partial capture in a production payment strategy.

Verify the integrationPerguntar à Athia sobre isto#

Before going live:

1. Confirm that the connection appears as active in DEUNA Admin.
2. Verify that the payment strategy routes only supported countries, currencies, cards, and operations to this connection.
3. Test Purchase or Authorization followed by a full Capture, according to the configured operation.
4. Confirm the final payment state through both webhook notifications and status polling.
5. Test full and partial refunds within the amount captured.
6. If you use Two Amounts mode, test how your integration handles a rejection caused by an exchange-rate change.

For account-specific availability or onboarding requirements, contact your DEUNA Technical Account Manager (TAM).