From 1d320026cd339e466f81df4978fc0fcd8a3f7c9a Mon Sep 17 00:00:00 2001
From: "Audrey (auva)" <auva@odoo.com>
Date: Tue, 28 Oct 2025 09:29:15 +0000
Subject: [PATCH] [ADD] payment_providers/dpo: create documentation for DPO Pay

task-4925278

X-original-commit: efa4971b648a3bc5ceae2e584331eef610b06f1e
---
 .../finance/payment_providers.rst             |  8 ++++
 .../finance/payment_providers/dpo.rst         | 45 +++++++++++++++++++
 2 files changed, 53 insertions(+)
 create mode 100644 content/applications/finance/payment_providers/dpo.rst

diff --git a/content/applications/finance/payment_providers.rst b/content/applications/finance/payment_providers.rst
index dbda8fe541..f91c7544dc 100644
--- a/content/applications/finance/payment_providers.rst
+++ b/content/applications/finance/payment_providers.rst
@@ -15,6 +15,7 @@ Online payments
    payment_providers/authorize
    payment_providers/buckaroo
    payment_providers/demo
+   payment_providers/dpo
    payment_providers/flutterwave
    payment_providers/mercado_pago
    payment_providers/mollie
@@ -98,6 +99,12 @@ Online payment providers
      -
      -
      -
+   * - :doc:`DPO Pay <payment_providers/dpo>`
+     - The provider's website
+     -
+     -
+     -
+     -
    * - :doc:`Flutterwave <payment_providers/flutterwave>`
      - The provider's website
      - |V|
@@ -474,6 +481,7 @@ payments from other payments.
    - :doc:`payment_providers/asiapay`
    - :doc:`payment_providers/buckaroo`
    - :doc:`payment_providers/demo`
+   - :doc:`payment_providers/dpo`
    - :doc:`payment_providers/mercado_pago`
    - :doc:`payment_providers/mollie`
    - :doc:`payment_providers/nuvei`
diff --git a/content/applications/finance/payment_providers/dpo.rst b/content/applications/finance/payment_providers/dpo.rst
new file mode 100644
index 0000000000..fd4acaee71
--- /dev/null
+++ b/content/applications/finance/payment_providers/dpo.rst
@@ -0,0 +1,45 @@
+=======
+DPO Pay
+=======
+
+`DPO Pay <https://dpogroup.com/>`_ is a payment provider based in Africa that operates across
+multiple countries on the continent.
+
+.. _payment_providers/dpo/configure_dashboard:
+
+DPO Pay account creation
+========================
+
+#. `Fill in the DPO Pay onboarding form <https://dpo-pay-network.odoo.com/form>`_ and upload
+   the required documents.
+#. Agree to the :guilabel:`Terms and Conditions` and click :guilabel:`Submit`.
+#. DPO Pay creates a test account based on the submitted information and sends you an email
+   containing your login credentials for the `DPO portal <https://portal.dpopay.com>`_
+   and the :ref:`test credentials <payment_providers/test-mode>` to enter in
+   :ref:`Odoo <payment_providers/dpo/configure_odoo>` if you want to try DPO Pay without affecting
+   live transactions.
+#. Once DPO has verified the information and documents, they will transition your test account to a
+   live account and send another email containing your live credentials to configure in
+   :ref:`Odoo <payment_providers/dpo/configure_odoo>`.
+
+.. _payment_providers/dpo/configure_odoo:
+
+Configuration in Odoo
+=====================
+
+#. :ref:`Navigate to the payment provider DPO Pay <payment_providers/add_new>`.
+#. Fill in the :guilabel:`Service ID` and :guilabel:`Company Token` fields with the
+   :ref:`information received from DPO Pay <payment_providers/dpo/configure_dashboard>`.
+#. Configure the remaining options to your liking.
+#. Set the :guilabel:`State` field to :guilabel:`Enabled` (or :guilabel:`Test Mode` if you are
+   trying DPO Pay as a :ref:`test <payment_providers/test-mode>`).
+
+.. note::
+   All `payment methods supported by DPO Pay <https://dpogroup.com/Payment-methods>`_ are grouped
+   under the :guilabel:`Card / Mobile` payment method. When they select this payment method,
+   customers are redirected to a DPO Pay page where they can select their preferred payment method.
+   To enable or disable specific payment options, contact `DPO Pay support
+   <https://dpogroup.com/contact-us/>`_.
+
+.. seealso::
+   :doc:`../payment_providers`