Payment ServicesMercadoPago

MercadoPago

Sana Commerce 9.2
Your connector

Configure Payment Methods

When the MercadoPago payment provider is configured in Sana Admin, you need to set up the necessary payment methods supported by MercadoPago.

To configure payment methods:

Step 1: In Sana Admin click: Setup > Ordering & checkout > Payment methods.

Step 2: On the Payment methods tab set up the necessary payment methods.

For more information about how to create and configure payment methods in Sana Admin, see 'Payment Methods' on the Sana help web site.

MercadoPago keys

Each MercadoPago application has two pairs of keys (Public and Private/Access token) to connect with the MercadoPago API. These keys represent the currency for the payment, for example MXN for Mexican Peso, ARS for Argentine Peso, BRL for Brazilian Real, etc.

The sandbox environment keys allow to make test payments and the production keys are used for real payments. One of the keys is public and the other one is private (ACCESS_TOKEN). Make sure to enter the correct keys and do not enter the private key elsewhere other than the "Payment provider: Access token" field in the Sana payment method settings. You can find these keys in the credentials section of your MercadoPago account.

The table below provides the description of the MercadoPago payment provider specific fields:

Fields Description
Public key Enter the public key which identifies your MercadoPago account for Custom Checkout. You can find it in the credentials section of your MercadoPago account.
Access token Enter the access token (private key). You can find it in the Custom Checkout credentials section of your MercadoPago account. It must be kept confidential in your backend servers and must never be published.
Client id Enter the client ID which identifies your MercadoPago account for Basic Checkout. You can find it in the credentials section of your MercadoPago account.
Client secret Enter the client secret. You can find it in the Basic Checkout credentials section of your MercadoPago account. It must be kept confidential in your backend servers and must never be published.
Currency id Enter the currency ID of the given public and private keys. It is very important to enter the correct currency ID. Contact MercadoPago to get further details regarding the currency type of the related account. It should correspond to the currency of the customers in your ERP system. The currencies differ for the countries for which you set up MercadoPago.

For more information about how to set up customer's currency in your ERP system, refer to the ERP user guide.

Amount round option Use this option to round up/down prices according to the allowed decimal places by MercadoPago.

Possible values:

  • UP
  • DOWN
Allowed payment categories Use this field to show only specific payment categories to the customers in the checkout process. Multiple payment categories should be separated with comma. Example: CARD, CASH, BDEP, BTFR.

If you leave this field empty, all available categories of the MercadoPago keys will be shown to the customers.

Available payment categories:

CARD - Credit Card
CASH - Cash
BDEP -  Bank Deposit
BTFR - Bank Transfer (available only in Chile)

Allowed payment methods Use this field to show only specific payment methods to the customers in the checkout process. Multiple payment methods should be separated with comma.

If you leave this field empty, all available payment methods will be shown to the customers.

Example: visa, master, mercadopagocard, oxxo, bancomer, serfin.

Blocked payment methods Use this field to hide specific payment methods. Payment methods entered in this field will not be shown to the customers in the checkout process. Multiple payment methods should be separated with comma.

Example: visa, master, mercadopagocard, oxxo, bancomer, serfin.

If a certain payment method is present in both fields, "Allowed payment methods" and "Blocked payment methods", it will be marked as allowed, because allowed payment methods have higher priority.

Validate Currency Code Use this field to check that the customer's currency and the currency of the selected MercadoPago payment method are the same.
  • true - If this setting is set to "true", then when a customer creates an order in a Sana web store, it will validate whether the customer's currency equals to the currency of the selected payment method. If they are not equal, the customer will not be able to pay the order.

  • false - The currencies are not validated. A customer will be able to pay the order regardless of his or her currency.

Test the payment flow, to see if everything works fine using the created payment methods.

Payment ServicesMercadoPago