From 90de933aa7da381c62032880a4bf636786933cd8 Mon Sep 17 00:00:00 2001 From: "Audrey (auva)" Date: Wed, 17 Dec 2025 14:22:41 +0100 Subject: [PATCH] [ADD] payment_providers/worldline: backport in 16.0 and 17.0 Backport Worldline documentation and add migration steps following Ogone end of support --- .../finance/payment_providers.rst | 8 ++ .../finance/payment_providers/ogone.rst | 5 ++ .../finance/payment_providers/worldline.rst | 88 +++++++++++++++++++ 3 files changed, 101 insertions(+) create mode 100644 content/applications/finance/payment_providers/worldline.rst diff --git a/content/applications/finance/payment_providers.rst b/content/applications/finance/payment_providers.rst index a424b30cb4..21b9d6f90f 100644 --- a/content/applications/finance/payment_providers.rst +++ b/content/applications/finance/payment_providers.rst @@ -24,6 +24,7 @@ Online payments payment_providers/razorpay payment_providers/sips payment_providers/stripe + payment_providers/worldline payment_providers/xendit Odoo embeds several **payment providers** that allow your customers to pay online, on their @@ -140,6 +141,12 @@ Online payment providers - Full only - Full and partial - |V| + * - :doc:`Worldline ` + - The provider's website + - |V| + - + - + - * - :doc:`Xendit ` - The provider's website - @@ -459,5 +466,6 @@ other payments. - :doc:`payment_providers/razorpay` - :doc:`payment_providers/sips` - :doc:`payment_providers/stripe` + - :doc:`payment_providers/worldline` - :doc:`payment_providers/xendit` - :doc:`accounting/bank` diff --git a/content/applications/finance/payment_providers/ogone.rst b/content/applications/finance/payment_providers/ogone.rst index aff240a7fe..2c5be828f0 100644 --- a/content/applications/finance/payment_providers/ogone.rst +++ b/content/applications/finance/payment_providers/ogone.rst @@ -2,6 +2,11 @@ Ogone ===== +.. important:: + As of January 1, 2026, Worldline, the company behind the Ogone payment solution, no longer + supports Ogone. Users of the Ogone payment provider in Odoo should :ref:`migrate to Worldline + `. + `Ogone `_, also known as **Ingenico Payment Services** is a France-based company that provides the technology involved in secure electronic transactions. diff --git a/content/applications/finance/payment_providers/worldline.rst b/content/applications/finance/payment_providers/worldline.rst new file mode 100644 index 0000000000..188a323259 --- /dev/null +++ b/content/applications/finance/payment_providers/worldline.rst @@ -0,0 +1,88 @@ +========= +Worldline +========= + +`Worldline `_ is a France-based company and the world's fourth largest +payment provider. + +Settings in Worldline +===================== + +.. _worldline/API-user: + +Create an API user +------------------ + +It is recommended to set up an **API user** to create transactions from Odoo to ensure that your +Worldline configuration remains safe even if credentials are compromised. Additionally, API users do +not require frequent password updates like regular accounts. + +To create an **API user**, proceed as follows: + +#. Log into your `Worldline Merchant Portal `_, + click the :icon:`fa-th` (:guilabel:`menu`) icon, and select :guilabel:`Back Office`. +#. Go to :menuselection:`Configuration --> Users` and click on :guilabel:`New User`. +#. Configure the following fields: + + #. Specify a :guilabel:`UserID`, :guilabel:`User's name`, :guilabel:`E-mail address`, and + :guilabel:`Timezone` of your choice. + #. Set the :guilabel:`Profile` field to :guilabel:`Admin`. + #. Enable :guilabel:`Special user for API`. + +.. tip:: + If you have already set up a user, make sure it is activated without any error. + +.. _worldline/set-up: + +Set up Worldline for Odoo +------------------------- + +Worldline must now be configured to accept payments from Odoo. + +#. From your merchant portal, go to :menuselection:`Developer --> Payment API` and click on + :guilabel:`Generate API key`. Copy the :guilabel:`API key ID` and the :guilabel:`Secret API key` + and save them for :ref:`later `. +#. Go to :menuselection:`Developer --> Webhooks` and click on :guilabel:`Generate webhook keys`. + Copy the :guilabel:`Webhook ID` and the associated :guilabel:`Secret webhook key` and + save them for :ref:`later `. +#. | Click :guilabel:`Add webhook endpoint`, enter your Odoo database's URL followed by + `/payment/worldline/webhook` in the :guilabel:`Endpoint url` field, and :guilabel:`Confirm`. + | For example: `https://example.odoo.com/payment/worldline/webhook`. + +.. _worldline/odoo-configuration: + +Settings in Odoo +================ + +To set up Worldline in Odoo: + +#. :ref:`Navigate to the payment provider Worldline `. +#. In the :guilabel:`Credentials` tab, enter the :guilabel:`PSPID` of your Worldline account and + fill in the :guilabel:`API Key`, :guilabel:`API Secret`, :guilabel:`Webhook Key`, and + :guilabel:`Webhook Secret` with the values you saved at the step :ref:`Set up Worldline for + Odoo `. +#. Configure the rest of the options to your liking. +#. Set the :guilabel:`State` field to :guilabel:`Enabled`. + +.. seealso:: + :doc:`../payment_providers` + +.. _worldline/ogone-migration: + +Migration from Ogone to Worldline +================================= + +As of January 1, 2026, Worldline, the company behind the Ogone payment solution, no longer supports +Ogone. Users of the :doc:`Ogone payment provider ` should migrate to Worldline. To do so, +follow these steps: + +#. Log into the `Worldline Merchant Portal `_ + using your Ogone account credentials. +#. Complete the :ref:`Worldline setup for Odoo `. The existing API key and secret + can be reused; however, **a new webhook key and secret must be regenerated**. +#. For on-premise installations or databases managed by a partner, update the Odoo installation + as described in the :doc:`/administration/on_premise/update` documentation, or by + contacting your integrating partner. +#. In Odoo, :ref:`install ` the :guilabel:`Payment Provider: Worldline` + (`payment_worldline`) module. +#. :ref:`Configure the Worldline payment provider `.