Contents
- Overview and availability
- Configure the integration
- Add the Mercado Pago payment type
- Work with Mercado Pago in an order
Overview and availability
Mercado Pago is a service for managing online payments.
The Mercado Pago integration provides the following features:
- creation of a link for paying an order from Simla;
- sending the link by email, chat, or another communication channel;
- automatic payment status updates after a transaction is completed;
- issuing refunds from the order;
- connecting multiple Mercado Pago accounts to one Simla account.
The integration is available if at least one of the following countries is enabled: Argentina, Brazil, Chile, Colombia, Mexico, Peru, Uruguay, or Venezuela.
The currency configured in Simla must be available in Mercado Pago.
Important!
See the current list of supported currencies. The Mercado Pago account currency must match the currency selected in Simla.
Configure the integration
Prerequisites and API key
To connect the module, you need a Mercado Pago account.
Before connecting Mercado Pago, open your Simla account, for example, https://yourstore.simla.com, and go to Settings → Integration → API access keys. Create an application programming interface (API) key, select the store, and enable the following methods:
Integration:
/api/integration-modules/{code}/api/integration-modules/{code}/edit
Payments:
/api/payment/create-invoice/api/payment/(updateInvoice|check)
Connect and configure a Mercado Pago account
In the Simla Marketplace, select Mercado Pago and click Connect. On the connection page, enter your Simla account URL and the API key created earlier.
After saving the connection details, open the Accounts section and enter the Mercado Pago Client ID and Secret Key.
These credentials are available after an application is created in Mercado Pago. Use test credentials to check the integration or production credentials to accept real payments.
After entering the credentials, click Save. The updated page displays the store, Client ID, Sandbox environment, and Confirm manually option.
The Confirm manually option lets you confirm or reject each payment from the order. If it is disabled, payments are accepted automatically and you must issue a refund to cancel an accepted payment.
The Sandbox field indicates whether test or production credentials are being used. Above the connected accounts table, a link opens the payment type settings in Simla.
Add the Mercado Pago payment type
After connecting Mercado Pago, go to Settings → Data books → Payment types and click Add to create a payment type.
In the Integrate with field, select the Mercado Pago account connected earlier. This link cannot be changed after the payment type is saved. Create a separate payment type for each connected account.
Configure invoice statuses
When a payment type is connected for the first time, configure the invoice status mapping. The same settings are applied by default to payment types created later, but they can be edited.
Click Configure in the Invoice statuses section to open the status mapping window.
If the existing statuses do not match the company's process, select the status to map, click Add new payment status, enter a name, and confirm it. Statuses created from this window are also available in the Payment statuses section.
Work with Mercado Pago in an order
After the integration is configured, the Mercado Pago payment type is available in the Payments block of the order.
Generate and send a payment link
After saving the order, you can generate a payment link. The following information and actions are then displayed:
- Link to pay: can be copied and sent to the customer in a chat.
- Send to email: sends the link to the email address specified in the order.
- Sum: total amount to be paid.
- Creation date: date when the link was generated.
- Invoice status: updates automatically when the payment is completed.
- Cancel: cancels the link.
- Status: updates automatically according to the configured status mapping.
- Paid date: date when the payment was completed.
When the customer opens the link, Mercado Pago displays its payment page.
Payment and refund
After a successful payment, its status is updated in the order according to the configured mapping. The Sum and Paid date fields also show the updated data.
To issue a refund, click Request a refund in the order. After the refund is confirmed, the payment status is updated automatically.