diff --git a/content/applications/finance/payment_acquirers.rst b/content/applications/finance/payment_acquirers.rst index 8c6094045..8b783aef4 100644 --- a/content/applications/finance/payment_acquirers.rst +++ b/content/applications/finance/payment_acquirers.rst @@ -86,7 +86,7 @@ Online payment acquirers | :doc:`SIPS | Redirection to the | | | | | ` | acquirer website | | | | +-------------------------------+----------------------+------------+-----------------+-----------+ -| :doc:`Stripe | Redirection to the | |V| | | | +| :doc:`Stripe | Redirection to the | |V| | |V| | | | ` | acquirer website | | | | +-------------------------------+----------------------+------------+-----------------+-----------+ diff --git a/content/applications/finance/payment_acquirers/stripe.rst b/content/applications/finance/payment_acquirers/stripe.rst index 080e1fca7..9d5244f0e 100644 --- a/content/applications/finance/payment_acquirers/stripe.rst +++ b/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 ` and :ref:`enable Stripe manually `. You can then :ref:`Fill in your - credentials `, :ref:`generate a webhook ` and enable the + credentials `, :ref:`generate a 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 `. + #. :ref:`Fill in your credentials `. #. :ref:`Generate a 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 `: The key solely used to identify the account with Stripe. -- :ref:`Secret Key `: The key to sign the merchant account with Stripe. +- :ref:`Publishable Key `: The key solely used to identify the account with Stripe. +- :ref:`Secret Key `: The key to sign the merchant account with Stripe. - :ref:`Webhook Signing Secret `: 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 ` are filled in, then click + Make sure your :ref:`Publishable and Secret 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 `. + +.. 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