[ADD] payment acquirers: add config steps for Amazon Payment Services

task-2802678

closes odoo/documentation#2532

Related: odoo/odoo#95860
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>

content/applications/finance/payment_acquirers.rst

@@ -10,6 +10,7 @@ Payment acquirers (credit cards, online payments)
    payment_acquirers/wire_transfer
    payment_acquirers/adyen
    payment_acquirers/alipay
+   payment_acquirers/amazon_payment_services
    payment_acquirers/authorize
    payment_acquirers/buckaroo
    payment_acquirers/flutterwave
@@ -73,6 +74,11 @@ Online payment acquirers
      -
      -
      -
+   * - :doc:`Amazon Payment Services <payment_acquirers/amazon_payment_services>`
+     - Payment from the acquirer website
+     -
+     -
+     -
    * - :doc:`Authorize.Net <payment_acquirers/authorize>`
      - Payment from Odoo
      - |V|

content/applications/finance/payment_acquirers/amazon_payment_services.rst

@@ -0,0 +1,44 @@
+=======================
+Amazon Payment Services
+=======================
+
+`Amazon Payment Services <https://flutterwave.com/>`_ or APS is an online payment provider
+established in Dubai offering several online payment options.
+
+.. _payment_acquirers/aps/configure-dashboard:
+
+Configuration on APS Dashboard
+==============================
+
+#. Log into your `Amazon Payment Services Dashboard <https://fort.payfort.com/>`_ and go to
+   :menuselection:`Integration Settings --> Security Settings`. Generate the
+   :guilabel:`Access Code` if none has been generated yet. Copy the values of the
+   :guilabel:`Merchant Identifier`, :guilabel:`Access Code`, :guilabel:`SHA Request Phrase` and
+   :guilabel:`SHA Response Phrase` fields, and save them for later.
+#. Enter your Odoo database URL in the :guilabel:`Origin URL`, for example:
+   `https://yourcompany.odoo.com/`. Then, click on :guilabel:`Save Changes`.
+#. Navigate to :menuselection:`Integration Settings --> Technical Settings` and click on
+   :guilabel:`Redirection`. Make sure :guilabel:`Status` is set to `Active` and select your
+   preferred payment methods underneath in :guilabel:`Payment Options`.
+#. | Set :guilabel:`Send Response Parameters` to :guilabel:`Yes` and enter your database URL
+     followed by `/payment/aps/return` in the :guilabel:`Redirection URL`.
+   | For example `https://yourcompany.odoo.com/payment/aps/return`.
+   | Enter your database URL followed by `/payment/aps/webhook` in the
+     :guilabel:`Direct Transaction Feedback` and :guilabel:`Notification URL` fields.
+   | For example `https://yourcompany.odoo.com/payment/aps/webhook`.
+   | Click on :guilabel:`Save Changes`.
+#. Under :menuselection:`Integration Settings --> Payment Page Template` you can customize the
+   look and feel of the Amazon Payment Services payment page (where customers fill out their
+   credit card details during payment).
+
+.. _payment_acquirers/aps/configure-odoo:
+
+Configuration on Odoo
+=====================
+
+#. :ref:`Navigate to the payment acquirer Amazon Payment Services <payment_acquirers/add_new>`,
+   change its state to :guilabel:`Enabled`, and make sure it is :guilabel:`Published`.
+#. In the :guilabel:`Credentials` tab, fill the :guilabel:`Merchant Identifier`,
+   :guilabel:`Access Code`, :guilabel:`SHA Request Phrase` and :guilabel:`SHA Response Phrase` with
+   the values you saved at the step :ref:`payment_acquirers/aps/configure-dashboard`.
+#. Configure the rest of the options to your liking.