Stripe¶
Stripe is a United States-based online payment solution provider allowing businesses to accept credit cards and other payment methods.
Create your Stripe account with Odoo¶
The method to acquire your credentials depends on your hosting type:
Navigate to the payment provider Stripe and click 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 Agree and submit. If all requested information has been submitted, you are then redirected to Odoo, and your payment provider is enabled.
Navigate to the payment provider Stripe and click 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 Agree and submit; you are then redirected to the payment provider Stripe in Odoo.
Select a payment journal.
Set the State field to Enabled.
Tip
To use an existing Stripe account, activate the Developer mode and enable Stripe manually. You can then Fill in your credentials, generate a webhook, and enable the payment provider.
You can also test Stripe using the Test mode. To do so, first, log into your Stripe dashboard and switch to the Test mode. Then, in Odoo, activate the Developer mode, navigate to the payment provider Stripe, fill in your API credentials with the test keys, and set the State field to Test Mode.
Fill in your credentials¶
If your API credentials are required to connect with your Stripe account, proceed as follows:
Go to the API keys page on Stripe, or log into your Stripe dashboard and go to .
In the Standard keys section, copy the Publishable key and the Secret key and save them for later.
In Odoo, navigate to the payment provider Stripe.
In the Credentials tab, fill in the Publishable Key and Secret Key fields with the values you previously saved.
Generate a webhook¶
If your Webhook Signing Secret is required to connect with your Stripe account, you can create a webhook automatically or manually.
Make sure your Publishable and Secret keys are filled in, then click Generate your Webhook.
Go to the Webhooks page on Stripe, or log into your Stripe dashboard and go to .
In the Hosted endpoints section, click Add endpoint. Then, in the Endpoint URL field, enter your Odoo database’s URL, followed by
/payment/stripe/webhook
, e.g.,https://yourcompany.odoo.com/payment/stripe/webhook
.Click Select events at the bottom of the form, then select the following events:
in the Charge section: charge.refunded and charge.refund.updated;
in the Payment intent section: payment_intent.amount_capturable_updated, payment_intent.succeeded and payment_intent.payment_failed;
in the Setup intent section: setup_intent.succeeded.
Click Add events.
Click Add endpoint, then click Reveal and save your Signing secret for later.
In Odoo, navigate to the payment provider Stripe.
In the Credentials tab, fill the Webhook Signing Secret field with the value you previously saved.
Note
You can select other events, but they are currently not processed by Odoo.
Enable local payment methods¶
Local payment methods are payment methods that are only available for specific providers and for specific countries and currencies.
Odoo supports the following local payment methods for Stripe:
Bancontact
EPS
giropay
iDEAL
Przelewy24 (P24)
To adapt the list of enabled payment methods, go to the Configuration tab and edit the list of Supported Payment Icons.
Note
If a payment icon record does not exist in the database and its related local payment method is listed above, it is automatically enabled with Stripe.
If a local payment method is not listed above, it is not supported and cannot be enabled.
Enable Apple Pay¶
To allow customers to use the Apple Pay button to pay their eCommerce orders, go to the Configuration tab, enable Allow Express Checkout, and click Enable Apple Pay.