mirror of
https://github.com/odoo/documentation.git
synced 2025-12-12 07:29:27 +07:00
c1c030e292
task-4378942
closes odoo/documentation#15477
X-original-commit: 1552795647
Signed-off-by: Audrey Vandromme (auva) <auva@odoo.com>
112 lines
5.3 KiB
ReStructuredText
112 lines
5.3 KiB
ReStructuredText
======
|
|
Stripe
|
|
======
|
|
|
|
`Stripe <https://stripe.com/>`_ is a United States-based online payment solution provider allowing
|
|
businesses to accept **credit cards** and other payment methods.
|
|
|
|
.. seealso::
|
|
- `List of countries supported by Stripe <https://stripe.com/global>`_
|
|
- `List of payment methods supported by Stripe <https://stripe.com/payments/payment-methods>`_
|
|
- :doc:`../payment_providers`
|
|
- :doc:`Use Stripe as a payment terminal in Point of Sale
|
|
<../../sales/point_of_sale/payment_methods/terminals/stripe>`
|
|
|
|
.. _payment_providers/stripe/create_account:
|
|
|
|
Create your Stripe account with Odoo
|
|
====================================
|
|
|
|
To create a new Stripe account and link it to your Odoo database, make sure the company's
|
|
:guilabel:`Email` is configured in the :ref:`company's settings <general/companies/company>`, then
|
|
follow the steps below according to your hosting type:
|
|
|
|
.. tabs::
|
|
.. group-tab:: Odoo Online
|
|
|
|
#. :ref:`Navigate to the payment provider Stripe <payment_providers/supported_providers>` and
|
|
click :guilabel:`Connect Stripe`.
|
|
#. Go through the setup process and confirm your email address when Stripe sends you a
|
|
confirmation email.
|
|
#. At the end of the process, click :guilabel:`Agree and submit`. If all requested information
|
|
has been submitted, you are then redirected to Odoo, and your payment provider is enabled.
|
|
|
|
.. group-tab:: Odoo.sh or On-premise
|
|
|
|
#. :ref:`Navigate to the payment provider Stripe <payment_providers/supported_providers>` and
|
|
click :guilabel:`Connect Stripe`.
|
|
#. Go through the setup process and confirm your email address when Stripe sends you a
|
|
confirmation email.
|
|
#. At the end of the process, click :guilabel:`Agree and submit`; you are then redirected to
|
|
the payment provider **Stripe** in Odoo.
|
|
#. :ref:`Fill in your credentials <payment_providers/stripe/manual_input>`.
|
|
#. Set the :guilabel:`State` field to :guilabel:`Enabled`.
|
|
|
|
.. tip::
|
|
If you have created an account instead of :ref:`linking an existing one
|
|
<payment_providers/stripe/manual_input>`, :ref:`enable the developer mode <developer-mode>`, then
|
|
click :guilabel:`Reset your Stripe Account` on the Stripe payment provider form, then
|
|
:ref:`fill in your Stripe account's credentials <payment_providers/stripe/manual_input>`.
|
|
|
|
.. _payment_providers/stripe/manual_input:
|
|
|
|
Manual credential input
|
|
=======================
|
|
|
|
Manual credential input is needed, for example, when linking an existing Stripe account to your
|
|
Odoo database, when using an account :ref:`created on Odoo.sh or On-premise
|
|
<payment_providers/stripe/create_account>`, or when :ref:`testing Stripe without affecting live
|
|
transactions <payment_providers/test-mode>`.
|
|
|
|
.. _payment_providers/stripe/stripe-configuration:
|
|
|
|
Stripe configuration
|
|
--------------------
|
|
|
|
#. Go to `the API keys page on Stripe <https://dashboard.stripe.com/account/apikeys>`_, or log into
|
|
your Stripe dashboard and go to :menuselection:`Developers --> API Keys`.
|
|
#. In the :guilabel:`Standard keys` section, copy the :guilabel:`Publishable key` and the
|
|
:guilabel:`Secret key` and save them for later.
|
|
|
|
Odoo configuration
|
|
------------------
|
|
|
|
#. :ref:`Enable the developer mode <developer-mode>`.
|
|
#. :ref:`Navigate to the Stripe payment provider <payment_providers/supported_providers>`.
|
|
#. In the :guilabel:`Credentials` tab, fill in the :guilabel:`Publishable Key` and
|
|
:guilabel:`Secret Key` fields with the values you :ref:`previously saved
|
|
<payment_providers/stripe/stripe-configuration>`.
|
|
#. Click :guilabel:`Generate your webhook`.
|
|
#. Configure the remaining options as needed.
|
|
#. Set the :guilabel:`State` field to :guilabel:`Enabled`.
|
|
|
|
.. tip::
|
|
- You can also test Stripe without affecting live transactions using the :ref:`test mode
|
|
<payment_providers/test-mode>` and the :ref:`API keys
|
|
<payment_providers/stripe/stripe-configuration>` of your `Stripe account's Test Mode or
|
|
a sandbox environment <https://docs.stripe.com/testing-use-cases>`_.
|
|
- To link the same Stripe account to :doc:`multiple companies
|
|
</applications/general/companies/multi_company>` in a database, :ref:`create an account
|
|
<payment_providers/stripe/create_account>` and :ref:`fill in the credentials
|
|
<payment_providers/stripe/manual_input>` for one company, then reuse the same credentials and
|
|
webhook for the others. To view the webhook, go to the `Webhooks page on Stripe
|
|
<https://dashboard.stripe.com/webhooks>`_, or log into your Stripe dashboard and go to
|
|
:menuselection:`Developers --> Webhooks`. Click the destination in the list, then click the
|
|
:icon:`fa-eye` (:guilabel:`Reveal secret`) icon next to the :guilabel:`Signing secret`
|
|
field and copy the value.
|
|
|
|
Enable Apple Pay
|
|
================
|
|
|
|
To allow customers to use the Apple Pay button to pay for their eCommerce orders, :ref:`navigate to
|
|
the Stripe payment provider <payment_providers/supported_providers>`, then go to the
|
|
:guilabel:`Configuration` tab, enable :guilabel:`Allow Express Checkout`, and click
|
|
:guilabel:`Enable Apple Pay`.
|
|
|
|
.. seealso::
|
|
:ref:`Express checkout and Google Pay <payment_providers/express_checkout>`
|
|
|
|
.. tip::
|
|
Stripe allows to :ref:`manually capture <payment_providers/manual_capture>` and :ref:`refund
|
|
<payment_providers/refunds>` payments either from Odoo or directly from the Stripe dashboard.
|