[ADD] payment_acquirers: add configuration steps for Flutterwave

task-2759117

closes odoo/documentation#1939

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

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|       |
 | <payment_acquirers/adyen>`       |                     |            |                |           |
-+-------------------------------+----------------------+------------+-----------------+-----------+
++----------------------------------+---------------------+------------+----------------+-----------+
 | :doc:`Alipay                     | Redirection to the  |            |                |           |
 | <payment_acquirers/alipay>`      | acquirer website    |            |                |           |
-+-------------------------------+----------------------+------------+-----------------+-----------+
++----------------------------------+---------------------+------------+----------------+-----------+
 | :doc:`Authorize.Net              | Payment from Odoo   | |V|        | |V|            |           |
-| <payment_acquirers/authorize>`|                      |            |                 |           |
+| <payment_acquirers/authorize>`   |                     |            |                |           |
-+-------------------------------+----------------------+------------+-----------------+-----------+
++----------------------------------+---------------------+------------+----------------+-----------+
 | :doc:`Buckaroo                   | Redirection to the  |            |                |           |
 | <payment_acquirers/buckaroo>`    | acquirer website    |            |                |           |
-+-------------------------------+----------------------+------------+-----------------+-----------+
++----------------------------------+---------------------+------------+----------------+-----------+
+| :doc:`Flutterwave                | Redirection to the  | |V|        |                |           |
+| <payment_acquirers/flutterwave>` | acquirer website    |            |                |           |
++----------------------------------+---------------------+------------+----------------+-----------+
 | :doc:`Mollie                     | Redirection to the  |            |                |           |
 | <payment_acquirers/mollie>`      | acquirer website    |            |                |           |
-+-------------------------------+----------------------+------------+-----------------+-----------+
++----------------------------------+---------------------+------------+----------------+-----------+
 | :doc:`Ogone                      | Redirection to the  | |V|        |                |           |
 | <payment_acquirers/ogone>`       | acquirer website    |            |                |           |
-+-------------------------------+----------------------+------------+-----------------+-----------+
++----------------------------------+---------------------+------------+----------------+-----------+
 | :doc:`PayPal                     | Redirection to the  |            |                |           |
 | <payment_acquirers/paypal>`      | acquirer website    |            |                |           |
-+-------------------------------+----------------------+------------+-----------------+-----------+
++----------------------------------+---------------------+------------+----------------+-----------+
 | PayU Latam                       | Redirection to the  |            |                |           |
 |                                  | acquirer website    |            |                |           |
-+-------------------------------+----------------------+------------+-----------------+-----------+
++----------------------------------+---------------------+------------+----------------+-----------+
 | PayUMoney                        | Redirection to the  |            |                |           |
 |                                  | acquirer website    |            |                |           |
-+-------------------------------+----------------------+------------+-----------------+-----------+
++----------------------------------+---------------------+------------+----------------+-----------+
 | :doc:`SIPS                       | Redirection to the  |            |                |           |
 | <payment_acquirers/sips>`        | acquirer website    |            |                |           |
-+-------------------------------+----------------------+------------+-----------------+-----------+
++----------------------------------+---------------------+------------+----------------+-----------+
 | :doc:`Stripe                     | Redirection to the  | |V|        | |V|            | |V|       |
 | <payment_acquirers/stripe>`      | acquirer website    |            |                |           |
-+-------------------------------+----------------------+------------+-----------------+-----------+
++----------------------------------+---------------------+------------+----------------+-----------+
 
 .. |V| replace:: ✔
 

content/applications/finance/payment_acquirers/flutterwave.rst

@@ -0,0 +1,41 @@
+===========
+Flutterwave
+===========
+
+`Flutterwave <https://flutterwave.com/>`_ 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 <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.
+
+.. _payment_acquirers/flutterwave/configure_odoo:
+
+Configuration on Odoo
+=====================
+
+#. :ref:`Navigate to the payment acquirer Flutterwave <payment_acquirers/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_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`