Mercado Pago - Wallet Connect

This page presents all information related to the Mercado Pago connection using Wallet Connect as payment. Use the following buttons to navigate to the desired section.

Connecting with Yuno

Mandatory fields when integrating via Yuno:


General information





Minimum amount:

Credit card Mastercard, American Express, Naranja, Argencard, Cabal, Cencosud, Nativa Mastercard, Tarjeta Shopping: $ 1,00
Credit card Visa: $ 2,00
*Some credit cards don't accept installments of less than $ 1,00.

Credit card: R$ 0,50 *
MercadoPago card: R$ 0,50
*Minimum value can vary with the number of installments chosen. Observe that some credit cards don't accept installments of less than R$ 5,00.

Credit card: $ 1.000 *
Debit card Webpay: $ 950
Some credit cards don't accept installments of less than $ 1.000.

Credit card Visa, Mastercard, American Express, Diners: $ 1.000
Davivienda: $1.600

Credit card Banamex, Bancomer, Amex and BanCoppel*:
  • Less than 1 installment: $ 10.00
  • More than 1 installment: $ 5.00
Credit card Banorte, Santander, Ixe, HSBC, Mifel, Inbursa, BanRegio, BanBajío, Invex, Banco Ahorro Famsa, Afirme and others:
  • Between 3 and 6 installments: $ 300
  • Between 9 and 18 installments: $ 500
Debit card (Visa and MasterCard): $ 5.00
*BanCoppel only applies 1 installment.

Credit and Debit Card: S/ 1.00

Debit card: $ 1,00
Credit card: $ 15,00

Maximum amount:

Credit card: $ 700.000,00

Credit card: R$ 60.000,00
MercadoPago card: R$ 60.000,00

Credit card: $ 7.000.000
Debit card Webpay: $ 3.000.000

Credit card Visa, Mastercard, American Express, Diners: $ 30.000.000
Credit card Crédito Fácil Codensa: $ 5.000.000
Davivienda: $ 150.000.000

Credit card and Debit Card (Visa and MasterCard): $ 200,000.00

Credit and Debit Card: S/ 30,000

Credit card and Debit Card: $ 300.000,00

TRX limit:

No, but it is important to inform the estimated volumes of a new integration in order to warn about the dimensioning to the tech teams, if necessary.

Support of international BIN:

Yes, supported for international credit and debit cards. The shopper pays the product's price on the sellers currency, and the conversion is done by the financial institution responsible for issuing the payment (the seller always recieves the financial transaction in the currency registered on their Mercado Pago account).

Activation of functionality:

There are many restrictions for international cards due to fraud prevention. Flexibilization for certain seller can be requested. Nevertheless, payment approval, even with the flexible motor, is very low due to bank rejection.

TRX without CVV:


Purchase TRX in 1-Step:

Supported in all countries.

Purchase TRX in 2-Step:

Supported in Argentina, Brasil, Mexico and Peru.

Support for recurrency:





Refund support:

Supported in all countries.

Partial refunds:

Supported in all countries.

Multiple refunds:

Supported in all countries.

Time to request refund:

Within 180 days of its approval date.

Time to process refund:

Argentina: 5-44 working days
Brazil: 7-10 working days
Chile: 10-13 working days
Colombia: 10-13 working days
Mexico: 3-31 working days
Peru: 7-9 working days
Uruguay: 5-44 working days


Void support:

Supported in all countries.

Void to Authorization:


Void to refund:



Notifications of chargebacks:


Defined period to make a chargeback:

In general, the buyer has up to 90 days, but there are exceptions.

Endpoint for disputes:

Yes, the chargeback API.

Maximum time to dispute a chargeback (provide evidence):

Argentina: 7 days
Brazil: 10 days
Chile: 7 days
Colombia: 7 days
Mexico: 7 days
Peru: 7 days
Uruguay: 7 days


E3DS v2:

Work in progress.

Testing guidelines for sandbox environment

Necessary fields for testing:

Public Key and Access Token

Requirements to create a sandbox payment:

To create a payment on the sandbox environment you need to use an email ending with, such as [email protected].

Test cards Argentina:

Card Number Security code Expiration date
Mastercard 5031755734530604 123 11/25
Visa 4509953566233704 123 11/25
American Express 371180303257522 1234 11/25

Test cards Brazil:

Card Number Security code Expiration date
Mastercard 5031433215406351 123 11/25
Visa 4235647728025682 123 11/25
American Express 375365153556885 1234 11/25

Test cards Chile:

Card Number Security code Expiration date
Mastercard 5416752602582580 123 11/25
Visa 4168818844447115 123 11/25
American Express 375778174461804 1234 11/25

Test cards Colombia:

Card Number Security code Expiration date
Mastercard 5254133674403564 123 11/25
Visa 4013540682746260 123 11/25
American Express 374378187755283 1234 11/25

Test cards Mexico:

Card Number Security code Expiration date
Visa 4075595716483764 123 11/25

Test cards Peru:

Card Number Security code Expiration date
Mastercard 5031755734530604 123 11/25
Visa 4009175332806176 123 11/25
American Express 371180303257522 1234 11/25

Test cards Uruguay:

Card Number Security code Expiration date
Mastercard 5031755734530604 123 11/25
Visa 4509953566233704 123 11/25

Limitations/ Specifications for testing:

To test different payment results, fill in the desired status in the cardholder's name:
Payment Status Description
APRO Approved payment
OTHE Declined for general error
CONT Pending payment
CALL Declined with validation to authorize
FUND Declined for insufficient amount
SECU Declined for invalid security code
EXPI Declined due to due date issue
FORM Declined due to form error

Identity document for APRO and OTHE payment status:
Argentina: DNI of the test user
Brazil: (CPF) 12345678909
Chile: (otro) 123456789
Colombia: 123456789
Mexico: -
Peru: 123456789
Uruguay: (CI) 12345678 (otro) 123456789

Testing steps

The Mercado Pago Wallet Connect works as an enrolled payment method. Therefore, you will need to start enrolling it before making a payment.

To make a payment using the Mercado Pago Wallet Connect, you should follow the steps:

  1. Create Customer
  2. Create Customer Session
  3. Retrieve Payment Methods Available (Optional)
  4. Enroll Payment Method
  5. Retrieve Payment Method by Customer Session
    • The response provides a redirect URL (provider.redirect.init_url), so the user can enroll in the payment method using the Mercado Pago service.
    • After the login, the user will be requested to connect a new payment method or use cash.
    • The user should add credit card info to add a secondary payment method.
    • By selecting the cash option, the connection is performed directly.
    • For additional information, refer to the Mercado Pago documentation. However, as a summary, you basically need to follow the next steps:
      • Create test users to use as a seller and as a customer while developing the integration. Mercado Pago uses these test users to replicate the production environment, and they can only interact with other test users. If you use a real account to pay a checkout created by a test user, you will receive an error message (invalid_users_involved).
      • Get your API credentials and set them on Yuno´s dashboard while creating the payment method. If you do not have an application started yet, create one following to get your API keys.
      • Both for enrollments with MercadoPago Wallet Connect or payments with the Mercado Pago Checkout Pro, use the account money available for the test user or test cards provided by Mercado Pago to make a payment.


  • Always check if you are logged in with a real account before completing a payment. You SHOULD NOT use a real account to perform tests.
  • Add account money to the test user account while creating it.
  1. Create Checkout Session
  2. Retrieve Payment Methods Available for Checkout to get the vaulted_token related to the payment enrolled before.
  3. Create Payment using the vaulted_token from the last step.

Integration configuration

Credentials and steps to obtain them:

They can be found on the Dashboard or in your Mercado Pago account by accessing Your Business > Settings > Management and Administration > Credentials.
Test credentials: Public Key, Access Token
Production credentials: Public Key, Access Token, Client ID, Client Secret

Dashboard configuration:

  1. Log in to
  2. Click Connections and then select Mercado Pago.
  3. Click Connect.
  4. Introduce Name and Country
  5. Select Mercado Pago Wallet Connect as Payment Method
  6. Introduce the Access Token
  7. Configure Settings
  8. Click Connect

Configuration of webhooks in partner:

Via dashboard:
  1. Create an application on the homepage of your Dashboard.
  2. With the application created, go to the Webhooks Notifications tab in your Dashboard and configure the URLs of production and test from which notifications will be received.
  3. You will also be able to experiment and test if the indicated URL is receiving notifications correctly, being able to verify the request, the response given by the server and the description of the event.
  4. If you need to identify multiple accounts, at the end of the indicated URL you can indicate the parameter ?customer=(sellername) endpoint to identify the sellers.
  5. Next, select the events from which you will receive notifications in json format via an HTTP POST to the URL specified above. An event is any type of update to the reported object, including status or attribute changes. See the events that can be configured in the table below.

Production environment

Specific procedure for a merchant to go live:

If the merchant is part of a group of corporations that Mercado Pago follows-up punctually, a call to validate the integration should be made, the test payments in Mercado Pago's system should ve revised, thinking on a progressive roll-out method, etc.