From 121be6a81e9ee9063c60ab6f33e796eb1efe65c0 Mon Sep 17 00:00:00 2001 From: "Antoine Vandevenne (anv)" Date: Mon, 7 Mar 2022 13:47:50 +0000 Subject: [PATCH] [ADD] payment_acquirers: add configuration steps for Flutterwave task-2759117 closes odoo/documentation#1939 Related: odoo/odoo#85514 Signed-off-by: Antoine Vandevenne (anv) --- .../finance/payment_acquirers.rst | 78 ++++++++++--------- .../finance/payment_acquirers/flutterwave.rst | 41 ++++++++++ 2 files changed, 82 insertions(+), 37 deletions(-) create mode 100644 content/applications/finance/payment_acquirers/flutterwave.rst diff --git a/content/applications/finance/payment_acquirers.rst b/content/applications/finance/payment_acquirers.rst index 52f129319..563061d58 100644 --- a/content/applications/finance/payment_acquirers.rst +++ b/content/applications/finance/payment_acquirers.rst @@ -12,6 +12,7 @@ Payment acquirers (credit cards, online payments) payment_acquirers/alipay payment_acquirers/authorize payment_acquirers/buckaroo + payment_acquirers/flutterwave payment_acquirers/mollie payment_acquirers/ogone payment_acquirers/paypal @@ -52,43 +53,46 @@ the payments that go directly on the bank account and follow the usual reconcili Online payment acquirers ------------------------ -+-------------------------------+----------------------+------------+-----------------+-----------+ -| | Payment flow | Save cards | Capture amount | Refund | -| | | | manually | from Odoo | -+===============================+======================+============+=================+===========+ -| :doc:`Adyen | Payment from Odoo | |V| | |V| | |V| | -| ` | | | | | -+-------------------------------+----------------------+------------+-----------------+-----------+ -| :doc:`Alipay | Redirection to the | | | | -| ` | acquirer website | | | | -+-------------------------------+----------------------+------------+-----------------+-----------+ -| :doc:`Authorize.Net | Payment from Odoo | |V| | |V| | | -| `| | | | | -+-------------------------------+----------------------+------------+-----------------+-----------+ -| :doc:`Buckaroo | Redirection to the | | | | -| ` | acquirer website | | | | -+-------------------------------+----------------------+------------+-----------------+-----------+ -| :doc:`Mollie | Redirection to the | | | | -| ` | acquirer website | | | | -+-------------------------------+----------------------+------------+-----------------+-----------+ -| :doc:`Ogone | Redirection to the | |V| | | | -| ` | acquirer website | | | | -+-------------------------------+----------------------+------------+-----------------+-----------+ -| :doc:`PayPal | Redirection to the | | | | -| ` | acquirer website | | | | -+-------------------------------+----------------------+------------+-----------------+-----------+ -| PayU Latam | Redirection to the | | | | -| | acquirer website | | | | -+-------------------------------+----------------------+------------+-----------------+-----------+ -| PayUMoney | Redirection to the | | | | -| | acquirer website | | | | -+-------------------------------+----------------------+------------+-----------------+-----------+ -| :doc:`SIPS | Redirection to the | | | | -| ` | acquirer website | | | | -+-------------------------------+----------------------+------------+-----------------+-----------+ -| :doc:`Stripe | Redirection to the | |V| | |V| | |V| | -| ` | acquirer website | | | | -+-------------------------------+----------------------+------------+-----------------+-----------+ ++----------------------------------+---------------------+------------+----------------+-----------+ +| | Payment flow | Save cards | Capture amount | Refund | +| | | | manually | from Odoo | ++==================================+=====================+============+================+===========+ +| :doc:`Adyen | Payment from Odoo | |V| | |V| | |V| | +| ` | | | | | ++----------------------------------+---------------------+------------+----------------+-----------+ +| :doc:`Alipay | Redirection to the | | | | +| ` | acquirer website | | | | ++----------------------------------+---------------------+------------+----------------+-----------+ +| :doc:`Authorize.Net | Payment from Odoo | |V| | |V| | | +| ` | | | | | ++----------------------------------+---------------------+------------+----------------+-----------+ +| :doc:`Buckaroo | Redirection to the | | | | +| ` | acquirer website | | | | ++----------------------------------+---------------------+------------+----------------+-----------+ +| :doc:`Flutterwave | Redirection to the | |V| | | | +| ` | acquirer website | | | | ++----------------------------------+---------------------+------------+----------------+-----------+ +| :doc:`Mollie | Redirection to the | | | | +| ` | acquirer website | | | | ++----------------------------------+---------------------+------------+----------------+-----------+ +| :doc:`Ogone | Redirection to the | |V| | | | +| ` | acquirer website | | | | ++----------------------------------+---------------------+------------+----------------+-----------+ +| :doc:`PayPal | Redirection to the | | | | +| ` | acquirer website | | | | ++----------------------------------+---------------------+------------+----------------+-----------+ +| PayU Latam | Redirection to the | | | | +| | acquirer website | | | | ++----------------------------------+---------------------+------------+----------------+-----------+ +| PayUMoney | Redirection to the | | | | +| | acquirer website | | | | ++----------------------------------+---------------------+------------+----------------+-----------+ +| :doc:`SIPS | Redirection to the | | | | +| ` | acquirer website | | | | ++----------------------------------+---------------------+------------+----------------+-----------+ +| :doc:`Stripe | Redirection to the | |V| | |V| | |V| | +| ` | acquirer website | | | | ++----------------------------------+---------------------+------------+----------------+-----------+ .. |V| replace:: ✔ diff --git a/content/applications/finance/payment_acquirers/flutterwave.rst b/content/applications/finance/payment_acquirers/flutterwave.rst new file mode 100644 index 000000000..74660e7c9 --- /dev/null +++ b/content/applications/finance/payment_acquirers/flutterwave.rst @@ -0,0 +1,41 @@ +=========== +Flutterwave +=========== + +`Flutterwave `_ is an online payments provider established in Nigeria and +covering several African countries and payment methods. + +.. _payment_acquirers/flutterwave/configure_dashboard: + +Configuration on Flutterwave Dashboard +====================================== + +#. Log into `Flutterwave Dashboard `_ 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. + +.. _payment_acquirers/flutterwave/configure_odoo: + +Configuration on Odoo +===================== + +#. :ref:`Navigate to the payment acquirer Flutterwave ` 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_acquirers/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_acquirers`