[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>
This commit is contained in:
parent
e6d9a9dac2
commit
c57decd8b0
@ -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 | | | |
|
||||
+-------------------------------+----------------------+------------+-----------------+-----------+
|
||||
|
||||
|
@ -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:`Secret Key <stripe/api_keys>`: The key to sign the merchant 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:`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
|
||||
|
Loading…
Reference in New Issue
Block a user