diff --git a/content/applications/sales/point_of_sale/payment_methods/terminals.rst b/content/applications/sales/point_of_sale/payment_methods/terminals.rst index 877bce080..c1d5d634c 100644 --- a/content/applications/sales/point_of_sale/payment_methods/terminals.rst +++ b/content/applications/sales/point_of_sale/payment_methods/terminals.rst @@ -22,6 +22,7 @@ Then, follow the corresponding documentation to configure your device: - :doc:`Adyen configuration ` - :doc:`Ingenico configuration ` +- :doc:`Mercado Pago configuration ` - :doc:`SIX configuration ` - :doc:`Stripe configuration ` - :doc:`Vantiv configuration ` @@ -36,6 +37,7 @@ the POS <../payment_methods>`. terminals/adyen terminals/ingenico + terminals/mercado_pago terminals/six terminals/stripe terminals/vantiv diff --git a/content/applications/sales/point_of_sale/payment_methods/terminals/mercado_pago.rst b/content/applications/sales/point_of_sale/payment_methods/terminals/mercado_pago.rst new file mode 100644 index 000000000..95ed9901b --- /dev/null +++ b/content/applications/sales/point_of_sale/payment_methods/terminals/mercado_pago.rst @@ -0,0 +1,116 @@ +============ +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 + `_. + +.. seealso:: + `Mercado Pago online payments + `_ + +.. _pos-mercado-pago-configuration: + +Configuration +============= + +#. Create a `Mercado Pago account `_. +#. Associate your Point Smart terminal with a :guilabel:`store` and a :guilabel:`cash drawer` by + following `Mercado Pago's documentation `_. + + .. note:: + All purchased terminals are automatically displayed on your Mercado dashboard. + +#. Set your Point Smart terminal to the :guilabel:`Point of Sale` operation mode. + + .. warning:: + Odoo does not support the :guilabel:`Standalone` operation mode. + +#. :ref:`Create a Point Smart application `. +#. :ref:`Generate your credentials `. +#. :ref:`Create and configure the related payment method `. + +.. _pos-mercado-pago-application: + +Point Smart application +----------------------- + +Create a new application from Mercado Pago's `developer panel +`_ by following `Mercado Pago's applications documentation +`_, making sure you select :guilabel:`In +person Payments`. + +.. _pos-mercado-pago-credentials: + +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`). + + .. image:: mercado_pago/webhooks.png + :alt: Webhooks configuration on Mercado Pago. + +.. _pos-mercado-pago-method: + +Payment method +-------------- + +#. Go to :menuselection:`Point of Sale --> Configuration --> Settings` and enable :guilabel:`Mercado + Pago` under the :guilabel:`Payment Terminals` section. +#. :doc:`Create the related payment method <../../payment_methods>` by going to + :menuselection:`Point of Sale --> Configuration --> Payment Methods`. +#. Set the journal type as :guilabel:`Bank` +#. Select :guilabel:`Mercado Pago` in the :guilabel:`Use a Payment Terminal` field. +#. Fill in the mandatory fields with the :ref:`previously generated credentials + `: + + - Fill in the :guilabel:`Production user token` field using the access token. + - Fill in the :guilabel:`Production secret key` field using the webhook secret key. + - Fill in the :guilabel:`Terminal S/N` field using the terminal serial number. You can find it at + the back of your terminal. + - Click the :guilabel:`Force PDV` button to activate the Point of Sale mode. + +.. image:: mercado_pago/payment-method.png + :alt: Form to create a new payment method. + +Select the payment method by going to the :ref:`POS' settings ` and adding +it to the payment method under the :guilabel:`Payment Methods` field of the :guilabel:`Payment` +section. + +.. _pos-mercado-pago-pay: + +Paying with a payment terminal +============================== + +When processing a payment, select your Mercado Pago payment method, check the amount, and click +:guilabel:`Send`. Once the payment is successful, the status changes to :guilabel:`Payment +Successful`. + +.. note:: + - In case of connection issues between Odoo and the payment terminal, force the payment by + clicking :guilabel:`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 :guilabel:`Cancel`. + +.. important:: + Any action made on the terminal should trigger a notification on the POS interface. Ensure the + :ref:`webhook secret key ` is correctly configured if you are not + notified. diff --git a/content/applications/sales/point_of_sale/payment_methods/terminals/mercado_pago/payment-method.png b/content/applications/sales/point_of_sale/payment_methods/terminals/mercado_pago/payment-method.png new file mode 100644 index 000000000..fc2f95625 Binary files /dev/null and b/content/applications/sales/point_of_sale/payment_methods/terminals/mercado_pago/payment-method.png differ diff --git a/content/applications/sales/point_of_sale/payment_methods/terminals/mercado_pago/webhooks.png b/content/applications/sales/point_of_sale/payment_methods/terminals/mercado_pago/webhooks.png new file mode 100644 index 000000000..1a3e7ce59 Binary files /dev/null and b/content/applications/sales/point_of_sale/payment_methods/terminals/mercado_pago/webhooks.png differ