From 624048c891c02f2a9be477236cac73ec3dc46a22 Mon Sep 17 00:00:00 2001 From: Valentin Chevalier Date: Wed, 6 Jul 2022 12:06:04 +0000 Subject: [PATCH] [IMP] payment_acquirers, stripe: add information about express checkout task-2754209 closes odoo/documentation#2392 Related: odoo/odoo#88374 Related: odoo/enterprise#29915 Signed-off-by: Antoine Vandevenne (anv) --- .../finance/payment_acquirers.rst | 48 +++++++++++++++---- .../finance/payment_acquirers/stripe.rst | 34 +++++++++++-- 2 files changed, 71 insertions(+), 11 deletions(-) diff --git a/content/applications/finance/payment_acquirers.rst b/content/applications/finance/payment_acquirers.rst index d3bf88cf9..d9b2440bb 100644 --- a/content/applications/finance/payment_acquirers.rst +++ b/content/applications/finance/payment_acquirers.rst @@ -64,84 +64,100 @@ Online payment acquirers * - - Payment flow - - :ref:`Save cards for later ` + - :ref:`Tokenization ` - :ref:`Manual capture ` - :ref:`Refunds ` + - :ref:`Express checkout ` * - :doc:`Adyen ` - Payment from Odoo - |V| - Full only - Full and partial + - * - :doc:`Alipay ` - Payment from the acquirer website - - - + - * - :doc:`Amazon Payment Services ` - Payment from the acquirer website - - - + - * - :doc:`AsiaPay ` - Payment from the acquirer website - - - + - * - :doc:`Authorize.Net ` - Payment from Odoo - |V| - Full only - Full only + - * - :doc:`Buckaroo ` - Payment from the acquirer website - - - + - * - :doc:`Flutterwave ` - Payment from the acquirer website - |V| - - + - * - :doc:`Mercado Pago ` - Payment from the acquirer website - - - - + - + - * - :doc:`Mollie ` - Payment from the acquirer website - - - + - * - :doc:`Ogone ` - Payment from the acquirer website - |V| - - + - * - :doc:`PayPal ` - Payment from the acquirer website - - - + - * - PayU Latam - Payment from the acquirer website - - - + - * - :doc:`Razorpay ` - Payment from Odoo - - Full only - Full and partial + - * - :doc:`SIPS ` - Payment from the acquirer website - - - + - * - :doc:`Stripe ` - Payment from the acquirer website - |V| - Full only - Full and partial + - |V| .. |V| replace:: ✔ @@ -176,13 +192,13 @@ features. .. _payment_acquirers/features/tokenization: -Save cards for later --------------------- +Tokenization +------------ -If your payment acquirer supports this feature, customers can choose to save their card details as a -**payment token** in Odoo. When they do, they will not have to enter their card details again when -making a subsequent payment. This is particularly useful for the eCommerce conversion rate and for -subscriptions that use recurring payments. +If your payment acquirer supports this feature, customers can choose to save their card for later. A +**payment token** is created in Odoo and can be used as a payment method for subsequent payments +without having to enter the card details again. This is particularly useful for the eCommerce +conversion rate and for subscriptions that use recurring payments. Enable this feature by navigating to the :guilabel:`Configuration` tab from your payment acquirer and by ticking the :guilabel:`Allow Saving Payment Methods` checkbox. @@ -246,6 +262,22 @@ not need to be enabled first. To refund a customer payment, navigate to it and c - Odoo does not support this feature for all payment acquirers but some allow to refund payments from their website interface. +.. _payment_acquirers/features/express_checkout: + +Express checkout +---------------- + +If your payment acquirer supports this feature, customers can use the **Google Pay** and **Apple +Pay** buttons to pay their eCommerce orders in one click without filling the contact form. Using one +of those buttons, they'll go straight from the cart to the confirmation page, stopping by the +payment form of Google or Apple to validate the payment. + +Enable this feature by navigating to the :guilabel:`Configuration` tab from your payment acquirer +and by ticking the :guilabel:`Allow Express Checkout` checkbox. + +.. note:: + All prices shown in the express checkout payment form are always taxes included. + .. _payment_acquirers/configuration: Configuration diff --git a/content/applications/finance/payment_acquirers/stripe.rst b/content/applications/finance/payment_acquirers/stripe.rst index 9304adf09..39874bb84 100644 --- a/content/applications/finance/payment_acquirers/stripe.rst +++ b/content/applications/finance/payment_acquirers/stripe.rst @@ -22,7 +22,7 @@ The method to acquire your credentials depends on your hosting type: #. Confirm your email address when Stripe sends you a confirmation email. #. At the end of the process, you are redirected to Odoo. If you submitted all the requested information, you are all set and your payment acquirer is enabled. - #. Your can continue to :ref:`stripe/local-payment-methods`. + #. You can continue to :ref:`stripe/local-payment-methods`. .. tip:: To use your own API keys, :ref:`activate the Developer mode ` and @@ -133,7 +133,7 @@ To set it up, enable the :guilabel:`Capture Amount Manually` option on Odoo, as 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 + 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:: @@ -169,5 +169,33 @@ listed, you don't have anything to do. listed above, it is considered enabled with Stripe. - If a local payment method is not listed above, it is not supported and cannot be enabled. +.. _stripe/express-checkout: + +Enable express checkout +======================= + .. seealso:: - - :doc:`../payment_acquirers` + :ref:`payment_acquirers/features/express_checkout` + +After ticking the :guilabel:`Allow Express Checkout` checkbox, **Google Pay** is enabled out of the +box, but **Apple Pay** requires extra steps: You must register your web domain with Apple. This can +be done either automatically from Odoo, or manually from Stripe. + +.. tabs:: + .. tab:: Register automatically from Odoo + + #. Navigate to your payment acquirer and make sure that it is :guilabel:`enabled`. + #. Go to the :guilabel:`Configuration` tab and click on the :guilabel:`Enable Apple Pay` + button. A notification shows that the web domain was successfully registered with Apple. + + .. tab:: Register manually from Stripe + + Visit the `Apple pay web domains page on Stripe + `_, or log into your Stripe + dashboard and go to :menuselection:`Settings --> Payments methods --> Apple Pay --> Configure + --> Web domains`. Then, click on :guilabel:`Add new domain` and insert the web domain of your + Odoo database into the pop-up form. Odoo already hosts the verification file of Stripe. Click + on :guilabel:`Add` to register your web domain with Apple. + +.. important:: + This operation must be repeated whenever your web domain changes.