[ADD] payment_acquirers: add configuration steps for AsiaPay

task-2845428

closes odoo/documentation#2628

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

content/applications/finance/payment_acquirers.rst

@@ -11,6 +11,7 @@ Payment acquirers (credit cards, online payments)
    payment_acquirers/adyen
    payment_acquirers/alipay
    payment_acquirers/amazon_payment_services
+   payment_acquirers/asiapay
    payment_acquirers/authorize
    payment_acquirers/buckaroo
    payment_acquirers/flutterwave
@@ -80,6 +81,11 @@ Online payment acquirers
      -
      -
      -
+   * - :doc:`AsiaPay <payment_acquirers/asiapay>`
+     - Payment from the acquirer website
+     -
+     -
+     -
    * - :doc:`Authorize.Net <payment_acquirers/authorize>`
      - Payment from Odoo
      - |V|
@@ -364,6 +370,7 @@ payment method... What best suit your needs.
    - :doc:`payment_acquirers/adyen`
    - :doc:`payment_acquirers/alipay`
    - :doc:`payment_acquirers/authorize`
+   - :doc:`payment_acquirers/asiapay`
    - :doc:`payment_acquirers/buckaroo`
    - :doc:`payment_acquirers/mercado_pago`
    - :doc:`payment_acquirers/mollie`

content/applications/finance/payment_acquirers/asiapay.rst

@@ -0,0 +1,41 @@
+=======
+AsiaPay
+=======
+
+`AsiaPay <https://www.asiapay.com/>`_ is an online payments provider established in Hong Kong and
+covering several Asian countries and payment methods.
+
+.. _payment_acquirers/asiapay/configure_dashboard:
+
+Configuration on AsiaPay Dashboard
+==================================
+
+#. Log into `AsiaPay Dashboard <https://www.paydollar.com/b2c2/eng/merchant/index.jsp>`_ and go to
+   :menuselection:`Profile --> Account Information`. Copy the values of the :guilabel:`Currency` and
+   :guilabel:`Secure Hash` fields and save them for later.
+#. | Go to :menuselection:`Profile --> Payment Account Settings` and enable the options
+     :guilabel:`Return Value Link (Datefeed)`
+   | Enter your Odoo database URL followed by `/payment/asiapay/webhook` in the
+     :guilabel:`Return Value Link (Datefeed)` text field.
+   | For example: `https://yourcompany.odoo.com/payment/asiapay/webhook`.
+   | Click on :guilabel:`Test` to check if the webhook is working correctly.
+#. Click on :guilabel:`Update` to finalize the configuration.
+
+.. _payment_acquirers/asiapay/configure_odoo:
+
+Configuration on Odoo
+=====================
+
+#. :ref:`Navigate to the payment acquirer AsiaPay <payment_acquirers/add_new>` and change its state
+   to :guilabel:`Enabled`.
+#. | In the :guilabel:`Credentials` tab, fill the :guilabel:`Merchant ID`, :guilabel:`Currency`, and
+     :guilabel:`Secure Hash Secret` with the values you saved at the step
+     :ref:`payment_acquirers/asiapay/configure_dashboard`.
+   | By default, the payment acquirer AsiaPay is configured to verify the secret hash with the hash
+     function `SHA1`. If a different function is :ref:`set on your account
+     <payment_acquirers/asiapay/configure_dashboard>`, activate the :ref:`developer mode
+     <developer-mode>` and set the same value to the field :guilabel:`Secure Hash Function` in Odoo.
+#. Configure the rest of the options to your liking.
+
+.. seealso::
+   - :doc:`../payment_acquirers`