Payment ServicesMercadoPago


Sana Commerce 9.3
Your connector

Additional Information


MercadoPago uses the latest currency codes for the currency IDs. Make sure that the same currency codes are setup in your ERP system. For more information, see:


User's first name and last name should not contain any numbers or special characters. Only English alphabet characters are allowed and are sent to MercadoPago.

If a user's name contain any forbidden characters, they are dropped and are not sent to MercadoPago.


IP ranges used in communications with MercadoPago

Whenever information is sent from MercadoPago to your Web server (for example from IPN or Webhooks), this information will be sent from one of the IPs in the range listed below: - - - - - -

Thus, you can protect your web store using a firewall that allows incoming traffic only from the above mentioned IPs.

SSL certificate and HTTPS communication

A Sana web store must run under HTTPS. MercadoPago uses SSL to guarantee a secure communication.

Refresh your credentials

By clicking on the refresh button, you can get new pairs of credentials. When you do this, the previous ones will stop being supported by MercadoPago and you will be no longer able to authenticate, if you don't update your code with the new credentials.

Use this function only when you think your credentials were breached or for other security matters, like password changing, from time to time.

Receive productive payments

Initially a Sana web store will only be able to interact with MercadoPago in a sandbox mode.

For you to receive productive payments, you first have to pass the homologation process. To do this, you have to select your web store in credentials, and complete a form with basic information about your business. After that your web store will be automatically activated, and you will be able to start using the production keys and receive real payments.

MercadoPago features which are supported/not supported by Sana

Field Status
Pay in cash Supported if available (was tested for Mexico with 7-Eleven and Oxxo payment types and was tested for Chile with Servipag payment type)
Pay through bank deposit Supported if available (Not tested, since this feature is not supported on the MercadoPago test environment)
Pay through bank transfer Supported if available (Not tested, since this feature is not supported on the MercadoPago test environment)
3D Security Supported if available (Not tested, since this feature is not supported on the MercadoPago test environment)
Show specific payment methods Supported (Tested only for Mexico and Chile)
Hide specific payment methods Supported (Tested only for Mexico and Chile)
Payment callbacks Supported (Tested only for Mexico and Chile)
Enable diagnostic level logging Supported (Tested only for Mexico and Chile)
Update status via task service Supported (Tested only for Mexico and Chile)
Charge credit cards in installments Not supported
Save Card details Not supported
Perform an authorization of funds (Full, Partial and Cancel) Not supported
Refunds and cancellations (Full/partial refunds and Cancel) Not supported
Get a fee for each transaction Not supported
Subscription Not supported
Request money by e-mail Not supported


If there are any issues with paying orders through MercadoPago:

  1. Check whether a customer is from Latin America. MercadoPago is available in Argentina, Brazil, Chile, Colombia, Mexico, Peru, Uruguay and Venezuela.
  2. Check whether you entered the correct values for the following parameters in the payment method settings and in the correct format. These values are case sensitive.
    • Public key
    • Access token
    • Client id
    • Client secret
  3. Check other payment method settings.
  4. Check whether the customer's currency is the same as the currency set for the payment method.
  5. When copying some MercadoPago field values to Sana Admin, check that there are no leading and trailing spaces.
Payment ServicesMercadoPago