Mercado Pago

Connecting a payment terminal allows you to offer a fluid payment flow to your customers and ease the work of your cashiers.

Important

Only Point Smart payment terminals in Argentina, Brazil, and Mexico are supported. They can be purchased on Mercado Pago’s website.

See also

Mercado Pago online payments

Configuration

  1. Create a Mercado Pago account.

  2. Associate your Point Smart terminal with a store and a cash drawer by following Mercado Pago’s documentation.

    Note

    All purchased terminals are automatically displayed on your Mercado dashboard.

  3. Set your Point Smart terminal to the Point of Sale operation mode.

    Warning

    Odoo does not support the Standalone operation mode.

  4. Create a Point Smart application.

  5. Generate your credentials.

  6. Create and configure the related payment method.

Point Smart application

Create a new application from Mercado Pago’s developer panel by following Mercado Pago’s applications documentation, making sure you select In person Payments.

Credentials

Once the Point Smart application is created, three credentials are required:

  • An access token that Odoo uses to call Mercado Pago.

  • A webhook secret key that Odoo uses to authenticate notifications sent by Mercado Pago.

  • The terminal serial number at the back of your Point Smart terminal.

Retrieve the access token and webhook secret key by following Mercado Pago’s credentials documentation. Then, copy and paste them into Odoo when creating the payment method.

Important

For the webhooks configuration, add the URL of your Odoo database (e.g., https://mycompany.odoo.com) followed by /pos_mercado_pago/notification (e.g., https://mycompany.odoo.com/pos_mercado_pago/notification).

Webhooks configuration on Mercado Pago.

Payment method

  1. Go to Point of Sale ‣ Configuration ‣ Settings and enable Mercado Pago under the Payment Terminals section.

  2. Create the related payment method by going to Point of Sale ‣ Configuration ‣ Payment Methods.

  3. Set the journal type as Bank

  4. Select Mercado Pago in the Use a Payment Terminal field.

  5. Fill in the mandatory fields with the previously generated credentials:

    • Fill in the Production user token field using the access token.

    • Fill in the Production secret key field using the webhook secret key.

    • Fill in the Terminal S/N field using the terminal serial number. You can find it at the back of your terminal.

    • Click the Force PDV button to activate the Point of Sale mode.

Form to create a new payment method.

Select the payment method by going to the POS’ settings and adding it to the payment method under the Payment Methods field of the Payment section.

Paying with a payment terminal

When processing a payment, select your Mercado Pago payment method, check the amount, and click Send. Once the payment is successful, the status changes to Payment Successful.

Note

  • In case of connection issues between Odoo and the payment terminal, force the payment by clicking Force Done, which allows you to validate the order. This option is only available after receiving an error message informing you that the connection failed.

  • To cancel the payment request, click Cancel.

Important

Any action made on the terminal should trigger a notification on the POS interface. Ensure the webhook secret key is correctly configured if you are not notified.