[FW][ADD] payment_providers: Nuvei

content/applications/finance/payment_providers.rst

@@ -17,6 +17,7 @@ Online payments
    payment_providers/flutterwave
    payment_providers/mercado_pago
    payment_providers/mollie
+   payment_providers/nuvei
    payment_providers/paypal
    payment_providers/razorpay
    payment_providers/stripe
@@ -113,6 +114,12 @@ Online payment providers
      -
      -
      -
+   * - :doc:`Nuvei <payment_providers/nuvei>`
+     - The provider's website
+     -
+     -
+     -
+     -
    * - :doc:`PayPal <payment_providers/paypal>`
      - The provider's website
      -
@@ -458,6 +465,7 @@ payments from other payments.
    - :doc:`payment_providers/demo`
    - :doc:`payment_providers/mercado_pago`
    - :doc:`payment_providers/mollie`
+   - :doc:`payment_providers/nuvei`
    - :doc:`payment_providers/paypal`
    - :doc:`payment_providers/razorpay`
    - :doc:`payment_providers/stripe`

content/applications/finance/payment_providers/nuvei.rst

@@ -0,0 +1,87 @@
+=====
+Nuvei
+=====
+
+`Nuvei <https://www.nuvei.com>`_ is a Canadian-based payment solution provider that covers
+several Latin American countries, the US, and Canada. It allows businesses to accept credit cards
+and several local payment methods.
+
+.. _payment_providers/nuvei/dashboard:
+
+Configuration on the Nuvei Dashboard
+====================================
+
+#. Create a Nuvei account, if necessary, via our `referral page <https://pages.nuvei.com/odoo-referral-0>`_.
+#. Nuvei uses two separate portals for Sandbox and Production environments. Utilize the
+   `Sandbox Dashboard <https://sandbox.nuvei.com/login>`_ to test the integration without charging
+   your customers. Once you are ready to accept payments, switch to the
+   `Production Dashboard <https://cpanel.nuvei.com/login>`_.
+#. Go to :guilabel:`Settings` in the left sidebar, select :guilabel:`My Integration Settings`, then
+   select your payment page in the :guilabel:`Website` dropdown menu.
+#. Copy the :guilabel:`Merchant ID` and :guilabel:`Site ID` values and save them for :ref:`later
+   <payment_providers/nuvei/odoo>`.
+#. Click :guilabel:`Reveal`, then copy the :guilabel:`Secret Key` and save it for :ref:`later
+   <payment_providers/nuvei/odoo>`.
+
+.. tip::
+   Nuvei supports additional functionality relating to error handling from the same page as above.
+   For example, the following options are available for handling failed transactions: Enable
+   :guilabel:`User Trap` to redirect users back to the payment page and allow them to attempt
+   another deposit or :guilabel:`Decline Recovery` to display a popup suggesting alternative or
+   similar payment methods.
+
+.. _payment_providers/nuvei/odoo:
+
+Configuration on Odoo
+=====================
+
+#. :ref:`Navigate to the payment provider Nuvei <payment_providers/add_new>` and fill in the
+   :guilabel:`Merchant Identifier`, :guilabel:`Site Identifier`, and :guilabel:`Secret Key` fields
+   with the information saved at the step :ref:`payment_providers/nuvei/dashboard`.
+#. To activate the provider, change its state to :guilabel:`Enabled` or :guilabel:`Test Mode`.
+#. Configure the rest of the options to your liking.
+
+.. tip::
+   You can also test Nuvei using the :ref:`test mode <payment_providers/test-mode>` and your Sandbox
+   Dashboard values.
+
+.. _payment_providers/nuvei/services:
+
+Payment methods
+===============
+
+Most Nuvei payment methods are **region specific**. The supported payment methods for each country
+are listed below:
+
++---------------------------------+----------------------------------+
+| **Argentina**                   | **Ecuador**                      |
+|                                 |                                  |
+| - Boleto                        | - Card (AMEX, Mastercard, Visa)  |
+| - Card (AMEX, Mastercard, Visa) | - Banco Guayaquil                |
+|                                 | - Banco Pichincha                |
++---------------------------------+----------------------------------+
+| **Brazil**                      | **Mexico**                       |
+|                                 |                                  |
+| - Boleto                        | - Card (AMEX, Mastercard, Visa)  |
+| - Card (AMEX, Mastercard, Visa) | - SPEI                           |
+| - Pix                           |                                  |
++---------------------------------+----------------------------------+
+| **Canada**                      | **Peru**                         |
+|                                 |                                  |
+| - Card (AMEX, Mastercard, Visa) | - Card (AMEX, Mastercard, Visa)  |
+|                                 | - Boleto                         |
++---------------------------------+----------------------------------+
+| **Chile**                       | **United States**                |
+|                                 |                                  |
+| - Card (AMEX, Mastercard, Visa) | - Card (AMEX, Mastercard, Visa)  |
+| - WebPay                        |                                  |
++---------------------------------+----------------------------------+
+| **Colombia**                    | **Uruguay**                      |
+|                                 |                                  |
+| - Card (AMEX, Mastercard, Visa) | - Abitab                         |
+| - PSE                           | - Card (AMEX, Mastercard, Visa)  |
+|                                 | - RedPagos                       |
++---------------------------------+----------------------------------+
+
+.. seealso::
+   :doc:`../payment_providers`