[ADD] payment_providers/redsys: create doc for Redsys

task-5081671

Author: auva-odoo

content/applications/finance/payment_providers.rst

@@ -22,6 +22,7 @@ Online payments
    payment_providers/paymob
    payment_providers/paypal
    payment_providers/razorpay
+   payment_providers/redsys
    payment_providers/stripe
    payment_providers/worldline
    payment_providers/xendit
@@ -140,6 +141,12 @@ Online payment providers
      - Full only
      - Full and partial
      -
+   * - :doc:`Redsys <payment_providers/redsys>`
+     - The provider's website
+     -
+     -
+     -
+     -
    * - :doc:`Stripe <payment_providers/stripe>`
      - Odoo
      - |V|
@@ -482,6 +489,7 @@ payments from other payments.
    - :doc:`payment_providers/paymob`
    - :doc:`payment_providers/paypal`
    - :doc:`payment_providers/razorpay`
+   - :doc:`payment_providers/redsys`
    - :doc:`payment_providers/stripe`
    - :doc:`payment_providers/worldline`
    - :doc:`payment_providers/xendit`

content/applications/finance/payment_providers/redsys.rst

@@ -0,0 +1,54 @@
+======
+Redsys
+======
+
+`Redsys <https://redsys.es>`_ is a Spain-based payment service provider that processes online and
+in-store payments for businesses across Europe. It allows merchants to accept major credit and debit
+cards, as well as other local payment methods supported by Spanish banks.
+
+.. _payment_providers/redsys/configure_redsys:
+
+Redsys account configuration
+============================
+
+#. `Create a Redsys account
+   <XXX don't know how>`_ if necessary and log in to the `Redsys test environment
+   <https://sis-t.redsys.es:25443/admincanales-web/index.jsp#/login>`_.
+#. Navigate to :menuselection:`Merchant Configuration` in the left part of the application page.
+#. Fill in the :guilabel:`Name`, :guilabel:`Merchant URL`, and :guilabel:`Merchant Email` fields in
+   the :guilabel:`Merchant Information` section.
+#. Set the fields in the :guilabel:`Configuration data` section as follows:
+
+   - :guilabel:`Online notification`: :guilabel:`With online notification: HTTP`
+   - :guilabel:`Synchronization`: :guilabel:`Synchronous`
+   - :guilabel:`Parameters in the URLs`: :guilabel:`Yes`
+
+#. Copy the merchant code and merchant terminal number displayed in the :guilabel:`Merchant
+   management` section and save them for :ref:`later <payment_providers/redsys/configure_odoo>`.
+
+   .. tip::
+      If you want to try the integration in Odoo without charging customers, click :guilabel:`See
+      key`, enter your user identifier and password to display the key, then copy the key in
+      :ref:`Odoo <payment_providers/redsys/configure_odoo>`. If not, proceed with the next step.
+
+#. Click :guilabel:`Pasar a producción` to switch to the live environment; you will then receive
+   an email that will guide you to obtain the keys for the live environment.
+#. Copy the key and save it for :ref:`later <payment_providers/redsys/configure_odoo>`.
+
+Once you have completed and tested one of the integrations in the test environment, you will need
+to contact Redsys to activate the production environment and start processing real payments.
+
+.. _payment_providers/redsys/configure_odoo:
+
+Configuration in Odoo
+=====================
+
+#. :ref:`Navigate to the payment provider Redsys <payment_providers/add_new>`.
+#. Fill in the :guilabel:`Merchant Code`, :guilabel:`Merchant Terminal`, and :guilabel:`Secret Key`
+   fields with the information saved at the step :ref:`payment_providers/redsys/configure_redsys`.
+#. Configure the rest of the options to your liking.
+#. Set the :guilabel:`State` field to :guilabel:`Enabled` (or :guilabel:`Test Mode` if you are
+   trying Redsys as a :ref:`test <payment_providers/test-mode>`).
+
+.. seealso::
+   :doc:`../payment_providers`