odoo-forge-bundle 0.1.0

package/payload/skills/odoo18-docs/references/docs/applications/finance/payment_providers/demo.md

@@ -0,0 +1,40 @@
+---
+title: "Demo"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/payment_providers/demo.html"
+---
+
+====
+# Demo
+
+Odoo's **Demo Payment Provider** allows you to test business flows involving online transactions
+without requiring real banking credentials.
+
+# Configuration
+
+.. seealso::
+   :ref:`payment_providers/add_new`
+
+> **important**:
+>    Switch the state to :guilabel:`Test Mode`.
+
+# Payment outcome
+
+Upon checkout or when paying a bill online, you can choose the payment outcome when using the demo
+payment provider. To do so, click on the :guilabel:`Payment Status` drop-down menu and select the
+desired outcome.
+
+.. image:: demo/demo-payment-outcome.png
+   :align: center
+   :alt: Payment status outcomes.
+
+# Transaction state
+
+If you selected :guilabel:`Pending` as **payment outcome**, you can change the state of the
+transaction straight from its form view. To access a transaction's form view, activate the
+:ref:`developer mode <developer-mode>`, and go to :menuselection:`Accounting / Website -->
+Configuration --> Payment Transactions`. Then, change the status of a transaction by clicking on the
+state bar (:guilabel:`Draft, Pending, Authorized, Confirmed, Cancelled, Error`).
+
+.. image:: demo/demo-view-form.png
+   :align: center
+   :alt: Transaction's status bar.

package/payload/skills/odoo18-docs/references/docs/applications/finance/payment_providers/flutterwave.md

@@ -0,0 +1,46 @@
+---
+title: "Flutterwave"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/payment_providers/flutterwave.html"
+---
+
+===========
+# Flutterwave
+
+[Flutterwave ](https://flutterwave.com/) is an online payments provider established in Nigeria and
+covering several African countries and payment methods.
+
+.. _payment_providers/flutterwave/configure_dashboard:
+
+# Configuration on Flutterwave Dashboard
+
+#. Log into [Flutterwave Dashboard ](https://dashboard.flutterwave.com/) and go to
+   :menuselection:`Settings --> API`. Copy the values of the :guilabel:`Public Key` and
+   :guilabel:`Secret Key` fields and save them for later.
+#. | Go to :menuselection:`Settings --> Webhooks` and enter your Odoo database URL followed by
+     `/payment/flutterwave/webhook` in the :guilabel:`URL` text field.
+   | For example: `https://yourcompany.odoo.com/payment/flutterwave/webhook`.
+#. Fill the :guilabel:`Secret hash` with a password that you generate and save its value for later.
+#. Make sure *all* the remaining checkboxes are ticked.
+#. Click on **Save** to finalize the configuration.
+
+.. image:: flutterwave/flutterwave-settings.png
+   :alt: Flutterwave settings
+
+.. _payment_providers/flutterwave/configure_odoo:
+
+# Configuration on Odoo
+
+#. :ref:`Navigate to the payment provider Flutterwave <payment_providers/add_new>` and change its
+   state to :guilabel:`Enabled`.
+#. In the :guilabel:`Credentials` tab, fill the :guilabel:`Public Key`, :guilabel:`Secret Key`, and
+   :guilabel:`Webhook Secret` with the values you saved at the step
+   :ref:`payment_providers/flutterwave/configure_dashboard`.
+#. Configure the rest of the options to your liking.
+
+   > **important**:
+>       If you choose to allow saving payment methods, it is recommended to only enable card payments
+      from Flutterwave dashboard, as only cards can be saved as payment tokens. To do so, go to your
+      Flutterwave Dashboard and then to :menuselection:`Settings --> Account Settings`.
+
+.. seealso::
+   - :doc:`../payment_providers`

package/payload/skills/odoo18-docs/references/docs/applications/finance/payment_providers/mercado_pago.md

@@ -0,0 +1,42 @@
+---
+title: "Mercado Pago"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/payment_providers/mercado_pago.html"
+---
+
+============
+# Mercado Pago
+
+[Mercado Pago ](https://www.mercadopago.com/) is an online payment provider covering several
+countries, currencies and payment methods in Latin America.
+
+.. _payment_providers/mercado_pago/configure_dashboard:
+
+# Configuration on Mercado Pago Dashboard
+
+#. Log into the [Mercado Pago Dashboard ](https://www.mercadopago.com.mx/developers/panel)
+   and select your application or create a new one.
+#. Select :guilabel:`Credenciales de producción` in the left part of the application page, then
+   select the industry, optionally enter your domain, and click :guilabel:`Activar credenciales
+   de producción`.
+#. Copy the :guilabel:`Access token` and save it for later.
+
+> **tip**:
+>    If you are trying Mercado Pago as a test, select :guilabel:`Credienciales de prueba` in the left
+   part of the application page, then copy the test :guilabel:`Access token`.
+
+.. image:: mercado_pago/mp-credentials.png
+   :alt: Production and testing credentials in Mercado Pago.
+
+.. _payment_providers/mercado_pago/configure_odoo:
+
+# Configuration on Odoo
+
+#. :ref:`Navigate to the payment provider Mercado Pago <payment_providers/add_new>` and change its
+   state to :guilabel:`Enabled`.
+#. In the :guilabel:`Credentials` tab, fill in the :guilabel:`Access Token` with the value you saved
+   at the :ref:`payment_providers/mercado_pago/configure_dashboard` step.
+#. Configure the rest of the options to your liking.
+
+.. seealso::
+   - :doc:`../payment_providers`
+   - [Mercado Pago Odoo webinar ](https://www.youtube.com/watch?v=CX8vPHMb1ic)

package/payload/skills/odoo18-docs/references/docs/applications/finance/payment_providers/mollie.md

@@ -0,0 +1,33 @@
+---
+title: "Mollie"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/payment_providers/mollie.html"
+---
+
+======
+# Mollie
+
+[Mollie ](https://www.mollie.com/) is an online payments platform established in the Netherlands.
+
+# Configuration
+
+.. seealso::
+   - :ref:`payment_providers/add_new`
+
+## Credentials tab
+
+Odoo needs your **API Credentials** to connect with your Mollie account, which comprise:
+
+- **API Key**: The test or live API Key depending on the configuration of the provider.
+
+You can copy your credentials from your Mollie account, and paste them in the related fields under
+the **Credentials** tab.
+
+To retrieve your API key, log into your Mollie account, go to
+:menuselection:`Developers --> API keys`, and copy your Test or Live **API Key**.
+
+> **important**:
+>    If you are trying Mollie as a test, with the Test API key, change the **State** to *Test Mode*.
+   We recommend doing this on a test Odoo database, rather than on your main database.
+
+.. seealso::
+   - :doc:`../payment_providers`

package/payload/skills/odoo18-docs/references/docs/applications/finance/payment_providers/nuvei.md

@@ -0,0 +1,88 @@
+---
+title: "Nuvei"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/payment_providers/nuvei.html"
+---
+
+=====
+# Nuvei
+
+[Nuvei ](https://www.nuvei.com) is a Canadian-based payment solution provider that covers
+several Latin American countries, the US, and Canada. It allows businesses to accept credit cards
+and several local payment methods.
+
+.. _payment_providers/nuvei/dashboard:
+
+# Configuration on the Nuvei Dashboard
+
+#. Create a Nuvei account, if necessary, via our [referral page ](https://pages.nuvei.com/odoo-referral-0).
+#. Nuvei uses two separate portals for Sandbox and Production environments. Utilize the
+   [Sandbox Dashboard ](https://sandbox.nuvei.com/login) to test the integration without charging
+   your customers. Once you are ready to accept payments, switch to the
+   [Production Dashboard ](https://cpanel.nuvei.com/login).
+#. Go to :guilabel:`Settings` in the left sidebar, select :guilabel:`My Integration Settings`, then
+   select your payment page in the :guilabel:`Website` dropdown menu.
+#. Copy the :guilabel:`Merchant ID` and :guilabel:`Site ID` values and save them for :ref:`later
+   <payment_providers/nuvei/odoo>`.
+#. Click :guilabel:`Reveal`, then copy the :guilabel:`Secret Key` and save it for :ref:`later
+   <payment_providers/nuvei/odoo>`.
+
+> **tip**:
+>    Nuvei supports additional functionality relating to error handling from the same page as above.
+   For example, the following options are available for handling failed transactions: Enable
+   :guilabel:`User Trap` to redirect users back to the payment page and allow them to attempt
+   another deposit or :guilabel:`Decline Recovery` to display a popup suggesting alternative or
+   similar payment methods.
+
+.. _payment_providers/nuvei/odoo:
+
+# Configuration on Odoo
+
+#. :ref:`Navigate to the payment provider Nuvei <payment_providers/add_new>` and fill in the
+   :guilabel:`Merchant Identifier`, :guilabel:`Site Identifier`, and :guilabel:`Secret Key` fields
+   with the information saved at the step :ref:`payment_providers/nuvei/dashboard`.
+#. To activate the provider, change its state to :guilabel:`Enabled` or :guilabel:`Test Mode`.
+#. Configure the rest of the options to your liking.
+
+> **tip**:
+>    You can also test Nuvei using the :ref:`test mode <payment_providers/test-mode>` and your Sandbox
+   Dashboard values.
+
+.. _payment_providers/nuvei/services:
+
+# Payment methods
+
+Most Nuvei payment methods are **region specific**. The supported payment methods and brands for
+each country are listed below:
+
++---------------------------------+----------------------------------+
+| **Argentina**                   | **Ecuador**                      |
+|                                 |                                  |
+| - Boleto                        | - Card (AMEX, Mastercard, Visa)  |
+| - Card (AMEX, Mastercard, Visa) | - AstroPay TEF (Banco Guayaquil, |
+|                                 |   Banco Pichincha, Facilito)     |
++---------------------------------+----------------------------------+
+| **Brazil**                      | **Mexico**                       |
+|                                 |                                  |
+| - Boleto                        | - Card (AMEX, Mastercard, Visa)  |
+| - Card (AMEX, Mastercard, Visa) | - SPEI                           |
+| - Pix                           | - Oxxo Pay                       |
++---------------------------------+----------------------------------+
+| **Canada**                      | **Peru**                         |
+|                                 |                                  |
+| - Card (AMEX, Mastercard, Visa) | - Card (AMEX, Mastercard, Visa)  |
+|                                 | - Boleto                         |
++---------------------------------+----------------------------------+
+| **Chile**                       | **United States**                |
+|                                 |                                  |
+| - Card (AMEX, Mastercard, Visa) | - Card (AMEX, Mastercard, Visa)  |
+| - WebPay                        |                                  |
++---------------------------------+----------------------------------+
+| **Colombia**                    | **Uruguay**                      |
+|                                 |                                  |
+| - Card (AMEX, Mastercard, Visa) | - Card (AMEX, Mastercard, Visa)  |
+| - PSE                           | - Local Payments (Abitab,        |
+|                                 |   RedPagos)                      |
++---------------------------------+----------------------------------+
+
+.. seealso::
+   :doc:`../payment_providers`

package/payload/skills/odoo18-docs/references/docs/applications/finance/payment_providers/paypal.md

@@ -0,0 +1,81 @@
+---
+title: "PayPal"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/payment_providers/paypal.html"
+---
+
+======
+# PayPal
+
+[Paypal ](https://www.paypal.com/) is an American online payment provider available worldwide and
+one of the few that does not charge a subscription fee.
+
+> **note**:
+>    While PayPal is available in [over 200 countries/regions
+   ](https://www.paypal.com/webapps/mpp/country-worldwide), only [a selection of currencies are
+   supported ](https://developer.paypal.com/docs/reports/reference/paypal-supported-currencies).
+
+.. _payment_providers/paypal/configuration-paypal:
+
+# Configuration in PayPal
+
+#. [Log into your PayPal Developer Dashboard ](https://developer.paypal.com/dashboard/).
+#. Click :guilabel:`Apps & Credentials` and click :guilabel:`Create App`.
+#. Enter an :guilabel:`App Name` and click :guilabel:`Create App`.
+#. Copy the :guilabel:`Client ID` and :guilabel:`Secret` and save them for
+   :ref:`later <payment_providers/paypal/configuration-odoo>`.
+
+> **important**:
+>    If you use customer names or addresses that include accented or non-Latin characters, you
+   **must** configure the encoding format of the payment request sent by Odoo to PayPal to avoid
+   transaction failures without notice. To do so, access the [PayPal button language encoding
+   setting ](https://www.paypal.com/cgi-bin/websrc?cmd=_profile-language-encoding), click
+   :guilabel:`More Options`, and set the :guilabel:`Encoding` field to :guilabel:`UTF-8`.
+
+   If you are trying PayPal as a test, access your :ref:`PayPal Sandbox account
+   <payment_providers/paypal/testing>` and [configure the encoding format for your sandbox account
+   ](https://sandbox.paypal.com/cgi-bin/customerprofileweb?cmd=_profile-language-encoding).
+
+> **tip**:
+>    For encrypted website payments & EWP_SETTINGS errors, please check the [PayPal documentation
+   ](https://developer.paypal.com/docs/online/).
+
+.. _payment_providers/paypal/configuration-odoo:
+
+# Configuration in Odoo
+
+#. :ref:`Navigate to the payment provider PayPal <payment_providers/add_new>`.
+#. In the :guilabel:`Credentials` tab, enter the :guilabel:`Email` linked to your PayPal account,
+   then fill in the :guilabel:`Client ID` and :guilabel:`Client Secret` fields with the values you
+   saved at the step :ref:`payment_providers/paypal/configuration-paypal`.
+#. Click :guilabel:`Generate your webhook` to create the :guilabel:`Webhook ID`.
+#. Set the :guilabel:`State` field to :guilabel:`Enabled`, and make sure the PayPal payment provider
+   is :guilabel:`Published`.
+#. Configure the remaining options as desired.
+
+.. _payment_providers/paypal/testing:
+
+# Testing
+
+PayPal provides two sandbox accounts that you can use to simulate live transactions:
+
+-  A business account (to use as the merchant account, e.g., `ab-1abc12345678@business.example.com`);
+-  A default personal account (to use as the shopper account, e.g.,
+   `ba-9cba87654321@personal.example.com`).
+
+To test the PayPal payment workflow in Odoo:
+
+#. Log into the [Paypal Developer Site ](https://developer.paypal.com/) using your PayPal
+   credentials and go to :menuselection:`Testing Tools --> Sandbox Accounts`.
+#. Click the :icon:`fa-ellipsis-v` (:guilabel:`ellipsis`) icon next to the sandbox business account
+   and select :guilabel:`View/Edit account`.
+#. Copy the :guilabel:`Email`, :guilabel:`Client ID`, and :guilabel:`Secret` and save them for the
+   next step.
+#. In Odoo, :ref:`configure the PayPal payment provider <payment_providers/paypal/configuration-odoo>`
+   with the values saved at the previous step and set the :guilabel:`State` field to
+   :guilabel:`Test Mode`.
+
+You can then run a test transaction from Odoo using the sandbox personal account.
+
+.. seealso::
+   - :ref:`payment_providers/test-mode`
+   - :doc:`../payment_providers`

package/payload/skills/odoo18-docs/references/docs/applications/finance/payment_providers/razorpay.md

@@ -0,0 +1,56 @@
+---
+title: "Razorpay"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/payment_providers/razorpay.html"
+---
+
+========
+# Razorpay
+
+[Razorpay ](https://razorpay.com/) is an online payments provider established in India and
+covering more than 100 payment methods.
+
+.. _payment_providers/razorpay/configure_dashboard:
+
+# Configuration on Razorpay Dashboard
+
+#. Log into [Razorpay Dashboard ](https://dashboard.razorpay.com/) and go to
+   :menuselection:`Settings --> API Keys`. Generate the new keys and copy the values of the
+   :guilabel:`Key Id` and :guilabel:`Secret Key` fields and save them for later.
+#. | Go to :menuselection:`Settings --> Webhooks`, click on :guilabel:`Create New Webhook`,
+     and enter your Odoo database URL followed by `/payment/razorpay/webhook` in
+     the :guilabel:`Webhook URL` text field.
+   | For example: `https://example.odoo.com/payment/razorpay/webhook`.
+#. Fill the :guilabel:`Secret` field with a password of your choice and save it for later.
+#. Make sure the :guilabel:`payment.authorized`, :guilabel:`payment.captured`,
+   :guilabel:`payment.failed`, :guilabel:`refund.failed` and :guilabel:`refund.processed`
+   checkboxes are ticked.
+#. Click on :guilabel:`Create Webhook` to finalize the configuration.
+
+.. _payment_providers/razorpay/recurring_payments:
+
+> **important**:
+>    The :guilabel:`Recurring payments` feature must
+   be activated if you want to make recurring payments.
+   Send a request to the [Razorpay Support team ](https://razorpay.com/support/#request) to
+   enable recurring payments.
+
+.. _payment_providers/razorpay/configure_odoo:
+
+# Configuration on Odoo
+
+#. :ref:`Navigate to the payment provider Razorpay <payment_providers/add_new>` and change its
+   state to :guilabel:`Enabled`.
+#. In the :guilabel:`Credentials` tab, fill the :guilabel:`Key Id`, :guilabel:`Key Secret`, and
+   :guilabel:`Webhook Secret` with the values you saved at the step
+   :ref:`payment_providers/razorpay/configure_dashboard`.
+#. Configure the rest of the options to your liking.
+
+> **important**:
+>   If you configure Odoo to capture amounts manually:
+
+  - Be aware that the **manual voiding** of a transaction is not supported by Razorpay.
+  - After **five days**, if the transaction hasn't been captured yet, it'll automatically be
+    **voided**.
+
+.. seealso::
+   - :doc:`../payment_providers`

package/payload/skills/odoo18-docs/references/docs/applications/finance/payment_providers/stripe.md

@@ -0,0 +1,119 @@
+---
+title: "Stripe"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/payment_providers/stripe.html"
+---
+
+======
+# Stripe
+
+[Stripe ](https://stripe.com/) is a United States-based online payment solution provider allowing
+businesses to accept **credit cards** and other payment methods.
+
+.. seealso::
+   - [List of countries supported by Stripe ](https://stripe.com/global)
+   - [List of payment methods supported by Stripe ](https://stripe.com/payments/payment-methods)
+
+# Create your Stripe account with Odoo
+
+The method to acquire your credentials depends on your hosting type:
+
+.. tabs::
+   .. group-tab:: Odoo Online
+
+      #. :ref:`Navigate to the payment provider Stripe <payment_providers/supported_providers>` and
+         click :guilabel:`Connect Stripe`.
+      #. Go through the setup process and confirm your email address when Stripe sends you a
+         confirmation email.
+      #. At the end of the process, click :guilabel:`Agree and submit`. If all requested information
+         has been submitted, you are then redirected to Odoo, and your payment provider is enabled.
+
+   .. group-tab:: Odoo.sh or On-premise
+
+      #. :ref:`Navigate to the payment provider Stripe <payment_providers/supported_providers>` and
+         click :guilabel:`Connect Stripe`.
+      #. Go through the setup process and confirm your email address when Stripe sends you a
+         confirmation email.
+      #. At the end of the process, click :guilabel:`Agree and submit`; you are then redirected to
+         the payment provider **Stripe** in Odoo.
+      #. :ref:`Fill in your credentials <stripe/api_keys>`.
+      #. :ref:`Generate a webhook <stripe/webhook>`.
+      #. Set the :guilabel:`State` field to :guilabel:`Enabled`.
+
+> **tip**:
+>    - To use an existing Stripe account, :ref:`activate the Developer mode <developer-mode>` and
+     :ref:`enable Stripe manually <payment_providers/add_new>`. You can then :ref:`Fill in your
+     credentials <stripe/api_keys>`, :ref:`generate a webhook <stripe/webhook>`, and enable the
+     payment provider.
+   - You can also test Stripe using the :ref:`payment_providers/test-mode`. To do so, first,
+     [log into your Stripe dashboard ](https://dashboard.stripe.com/dashboard) and switch to the
+     **Test mode**. Then, in Odoo, :ref:`activate the Developer mode <developer-mode>`,
+     :ref:`navigate to the payment provider Stripe <payment_providers/supported_providers>`,
+     :ref:`fill in your API credentials <stripe/api_keys>` with the test keys, and set the
+     :guilabel:`State` field to :guilabel:`Test Mode`.
+
+.. _stripe/api_keys:
+
+## Fill in your credentials
+
+If your **API credentials** are required to connect with your Stripe account, proceed as follows:
+
+#. Go to [the API keys page on Stripe ](https://dashboard.stripe.com/account/apikeys), or log into
+   your Stripe dashboard and go to :menuselection:`Developers --> API Keys`.
+#. In the :guilabel:`Standard keys` section, copy the :guilabel:`Publishable key` and the
+   :guilabel:`Secret key` and save them for later.
+#. In Odoo, :ref:`navigate to the payment provider Stripe <payment_providers/supported_providers>`.
+#. In the :guilabel:`Credentials` tab, fill in the :guilabel:`Publishable Key` and
+   :guilabel:`Secret Key` fields with the values you previously saved.
+
+.. _stripe/webhook:
+
+## Generate a webhook
+
+If your **Webhook Signing Secret** is required to connect with your Stripe account, you can create a
+webhook automatically or manually.
+
+.. tabs::
+   .. tab:: Create the webhook automatically
+
+      Make sure your :ref:`Publishable and Secret keys <stripe/api_keys>` are filled in, then click
+      :guilabel:`Generate your webhook`.
+
+   .. tab:: Create the webhook manually
+
+      #. Go to the [Webhooks page on Stripe ](https://dashboard.stripe.com/webhooks), or log into
+         your Stripe dashboard and go to :menuselection:`Developers --> Webhooks`.
+      #. In the :guilabel:`Hosted endpoints` section, click :guilabel:`Add endpoint`. Then, in the
+         :guilabel:`Endpoint URL` field, enter your Odoo database's URL, followed by
+         `/payment/stripe/webhook`, e.g., `https://yourcompany.odoo.com/payment/stripe/webhook`.
+      #.  Click :guilabel:`Select events` at the bottom of the form, then select the following
+          events:
+
+          - in the :guilabel:`Charge` section: :guilabel:`charge.refunded` and
+            :guilabel:`charge.refund.updated`;
+          - in the :guilabel:`Payment intent` section:
+            :guilabel:`payment_intent.amount_capturable_updated`,
+            :guilabel:`payment_intent.payment_failed`, :guilabel:`payment_intent.processing`, and
+            :guilabel:`payment_intent.succeeded`;
+          - in the :guilabel:`Setup intent` section: :guilabel:`setup_intent.succeeded`.
+
+      #. Click :guilabel:`Add events`.
+      #. Click :guilabel:`Add endpoint`, then click :guilabel:`Reveal` and save your
+         :guilabel:`Signing secret` for later.
+      #. In Odoo, :ref:`navigate to the payment provider Stripe
+         <payment_providers/supported_providers>`.
+      #. In the :guilabel:`Credentials` tab, fill the :guilabel:`Webhook Signing Secret` field with
+         the value you previously saved.
+
+      > **note**:
+>          You can select other events, but they are currently not processed by Odoo.
+
+# Enable Apple Pay
+
+To allow customers to use the Apple Pay button to pay their eCommerce orders, go to the
+:guilabel:`Configuration` tab, enable :guilabel:`Allow Express Checkout`, and click
+:guilabel:`Enable Apple Pay`.
+
+.. seealso::
+   - :ref:`Express checkout and Google Pay <payment_providers/express_checkout>`
+   - :doc:`../payment_providers`
+   - :doc:`Use Stripe as a payment terminal in Point of Sale <../../sales/point_of_sale/payment_methods/terminals/stripe>`

package/payload/skills/odoo18-docs/references/docs/applications/finance/payment_providers/wire_transfer.md

@@ -0,0 +1,57 @@
+---
+title: "Wire transfers"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/payment_providers/wire_transfer.html"
+---
+
+==============
+# Wire transfers
+
+The **Wire transfer** payment method allows you to provide payment instructions to your customers,
+such as the bank details and communication. They are displayed:
+
+- at the end of the checkout process, once the customer has selected :guilabel:`Wire transfer` as a
+  payment method and clicked the :guilabel:`Pay now` button:
+
+  .. image:: wire_transfer/payment_instructions_checkout.png
+     :alt: Payment instructions at checkout
+
+- on the customer portal:
+
+  .. image:: wire_transfer/payment_instructions_portal.png
+     :alt: Payment instructions on the customer portal
+
+> **note**:
+>    - While this method is very accessible and requires minimal setup, it is very inefficient
+     process-wise. We recommend setting up a :doc:`payment provider <../payment_providers>` instead.
+   - Online orders remain in the :guilabel:`Quotation sent` (i.e., unpaid order) stage until you
+     receive the payment and :guilabel:`Confirm` the order.
+
+> **tip**:
+>    **Wire transfer** can be used as a template for other payment methods that are processed
+   manually, such as checks, by renaming or duplicating it.
+
+# Configuration
+
+To configure **Wire Transfer**, go to :menuselection:`Accounting / Website --> Configuration -->
+Payment Providers`, and open the :guilabel:`Wire Transfer` card. Then, in the
+:guilabel:`Configuration` tab:
+
+- Select the :guilabel:`Communication` to be used;
+
+  - :guilabel:`Based on Document Reference`: sales order or invoice number
+  - :guilabel:`Based on Customer ID`: customer identifier
+
+- Tick the :guilabel:`Enable QR codes` check box to activate :doc:`QR code payments
+  <../accounting/customer_invoices/epc_qr_code>`.
+
+Define the payment instructions in the :guilabel:`Messages` tab:
+
+.. image:: wire_transfer/payment_instructions.png
+   :alt: Define payment instructions
+
+If you have already defined :doc:`a bank account <../accounting/bank>`, the account number will be
+automatically added to the default message generated by Odoo. You can also add it afterwards and
+update the message by clicking :guilabel:`Reload pending message`.
+
+.. seealso::
+   :ref:`payment_providers/journal`

package/payload/skills/odoo18-docs/references/docs/applications/finance/payment_providers/worldline.md

@@ -0,0 +1,68 @@
+---
+title: "Worldline"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/payment_providers/worldline.html"
+---
+
+=========
+# Worldline
+
+[Worldline ](https://worldline.com/) 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 ](https://merchant-portal.preprod.worldline-solutions.com/dashboard),
+   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 <wordline/odoo-configuration>`.
+#. 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 <wordline/odoo-configuration>`.
+#. | 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`.
+
+.. _wordline/odoo-configuration:
+
+# Settings in Odoo
+
+To set up Worldline in Odoo:
+
+#. :ref:`Navigate to the payment provider Worldline <payment_providers/add_new>` and change its
+   state to :guilabel:`Enabled`.
+#. 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 <worldline/set-up>`.
+#. Configure the rest of the options to your liking.
+
+.. seealso::
+   :doc:`../payment_providers`