[IMP] payment_acquirers/stripe: split authorization and capture

Add documentation about the manual capture for Stripe

task-2781377

closes odoo/documentation#1642

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

content/applications/finance/payment_acquirers.rst

@@ -86,7 +86,7 @@ Online payment acquirers
 | :doc:`SIPS                    | Redirection to the   |            |                 |           |
 | <payment_acquirers/sips>`     | acquirer website     |            |                 |           |
 +-------------------------------+----------------------+------------+-----------------+-----------+
-| :doc:`Stripe                  | Redirection to the   | |V|        |                 |           |
+| :doc:`Stripe                  | Redirection to the   | |V|        | |V|             |           |
 | <payment_acquirers/stripe>`   | acquirer website     |            |                 |           |
 +-------------------------------+----------------------+------------+-----------------+-----------+
 

content/applications/finance/payment_acquirers/stripe.rst

@@ -27,7 +27,7 @@ The method to acquire your credentials depends on your hosting type:
       .. tip::
          To use your own API keys, :ref:`activate the Developer mode <developer-mode>` and
          :ref:`enable Stripe manually <payment_acquirers/add_new>`. You can then :ref:`Fill in your
-         credentials <stripe/api_keys>`, :ref:`generate a webhook <stripe/webhook>` and enable the
+         credentials <stripe/api-keys>`, :ref:`generate a webhook <stripe/webhook>` and enable the
          payment acquirer.
 
    .. group-tab:: Odoo.sh or On-premise
@@ -37,7 +37,7 @@ The method to acquire your credentials depends on your hosting type:
       #. Fill in the requested information and submit the form.
       #. Confirm your email address when Stripe sends you a confirmation email.
       #. At the end of the process, you are redirected to the payment acquirer **Stripe** on Odoo.
-      #. :ref:`Fill in your credentials <stripe/api_keys>`.
+      #. :ref:`Fill in your credentials <stripe/api-keys>`.
       #. :ref:`Generate a webhook <stripe/webhook>`.
       #. Enable the payment acquirer.
       #. You are all set and can continue to :ref:`stripe/local-payment-methods`.
@@ -51,7 +51,7 @@ The method to acquire your credentials depends on your hosting type:
    If you are testing Stripe (in **test mode**), change the **State** to *Test Mode*. We recommend
    doing this on a test Odoo database rather than on your main database.
 
-.. _stripe/api_keys:
+.. _stripe/api-keys:
 
 Fill in your credentials
 ------------------------
@@ -59,8 +59,8 @@ Fill in your credentials
 In case your **API Credentials** are required to connect with your Stripe account, these are the
 credentials that must be completed:
 
-- :ref:`Publishable Key <stripe/api_keys>`: The key solely used to identify the account with Stripe.
+- :ref:`Publishable Key <stripe/api-keys>`: The key solely used to identify the account with Stripe.
-- :ref:`Secret Key <stripe/api_keys>`: The key to sign the merchant account with Stripe.
+- :ref:`Secret Key <stripe/api-keys>`: The key to sign the merchant account with Stripe.
 - :ref:`Webhook Signing Secret <stripe/webhook>`: When you enable your webhook on your Stripe
   account, this signing secret must be set to authenticate the messages sent from Stripe to Odoo.
 
@@ -79,7 +79,7 @@ create a webhook either automatically or manually.
 .. tabs::
    .. tab:: Manage the webhook automatically
 
-      Make sure your :ref:`Publishable and Secret keys <stripe/api_keys>` are filled in, then click
+      Make sure your :ref:`Publishable and Secret keys <stripe/api-keys>` are filled in, then click
       on the :guilabel:`Generate your Webhook` button.
 
       .. tip::
@@ -113,6 +113,32 @@ create a webhook either automatically or manually.
          To update an existing webhook, click on it. Then, click on the three dots at the right side
          of the **Webhook URL** and on :guilabel:`Update details`.
 
+Configuration tab
+-----------------
+
+.. _stripe/manual-capture:
+
+Place a hold on a card
+~~~~~~~~~~~~~~~~~~~~~~
+
+Stripe allows you to **capture an amount manually** instead of having an immediate capture. This
+feature earmarks an amount on the customer's account for a determined period of time that depends on
+the payment method used.
+
+To set it up, enable the :guilabel:`Capture Amount Manually` option on Odoo, as explained in the
+:ref:`payment acquirers documentation <payment_acquirers/capture_amount>`.
+
+.. warning::
+   When the manual capture feature is activated, your customers are not able to proceed with any
+   payment if unsupported payment methods are selected.
+
+.. caution::
+   Odoo doesn't support the partial capture yet. Be aware that a partial capture from Stripe's 
+   interface is still managed as a full capture by Odoo.
+
+.. seealso::
+   - :doc:`../payment_acquirers`
+
 .. _stripe/local-payment-methods:
 
 Enable local payment methods