29,006
edits
Changes
m
→Configuration
Line 3:
Line 3:
Links below will be automatically replicated on translated pages by PolyglotBot -->
Links below will be automatically replicated on translated pages by PolyglotBot -->
[[fr:Module Stripe FR]]
[[fr:Module Stripe FR]]
−[[es::Módulo Stripe]]
+[[es:Módulo Stripe]]
<!-- END interlang links -->
<!-- END interlang links -->
Line 12:
Line 12:
nom=Stripe|
nom=Stripe|
num=50300|
num=50300|
−devdoc=|
+devdoc=[[Online Payment Module Architecture]]|
userdoc=This page|}}
userdoc=This page|}}
Line 27:
Line 27:
*to bind your Dolibarr third parties to Stripe customers
*to bind your Dolibarr third parties to Stripe customers
−*to display the list of the Stripe mode of payment in Stripe in Dolibarr
+*to display the list of the Stripe mode of payment in Dolibarr
−*to pay, using Strong Customer Authentication (SCA), for orders, invoices, lines of contracts, subscriptions or any free amount, online, using Stripe (https://www.stripe.com). See the note at bottom of this page to use the version "SCA ready" of module
+*to display the list of payments and payouts in Dolibarr
+*to pay, using Strong Customer Authentication (SCA), for orders, invoices, lines of contracts, subscriptions or any free amount, online, using Stripe (https://www.stripe.com). See the note at bottom of this page to use the version "SCA ready" of module.
Dolibarr is an official [[File:L Color Solid.svg|link=https://www.stripe.com/about]]
Dolibarr is an official [[File:L Color Solid.svg|link=https://www.stripe.com/about]]
−=Installation=
+=Installation / Upgrade=
{{NoInstallModuleEn}}
{{NoInstallModuleEn}}
+
+Also, because this is a native module, if you need to upgrade the module, you must just upgrade your Dolibarr application.
=Configuration=
=Configuration=
Line 44:
Line 47:
[[File:Doc setup stripe 1.png]]
[[File:Doc setup stripe 1.png]]
</div>
</div>
+
+
+'''What about the Restricted API keys ?'''
+
+This chapter has not been tested yet !!!!
+
+A restricted API key allows you to specify which Stripe resources the API key has access to read and/or write.
+To create a restricted key, follow the [https://stripe.com/docs/keys#create-restricted-api-secret-key steps provided by Stripe]. When creating the key, the permissions needed by Dolibarr include:
+
+* Customers: <code>write</code>
+* Events: <code>read</code>
+* PaymentIntents: <code>write</code>
+* SetupIntents: <code>write</code>
+* Checkout Sessions: <code>write</code>
+
+Then, you can replace the secret key with this new restricted key.
=Usage=
=Usage=
Line 60:
Line 79:
The v10 is ready for this change. Dolibarr v10 offers 2 other modes of operation:
The v10 is ready for this change. Dolibarr v10 offers 2 other modes of operation:
−* By going to Home - Setup - Other and adding the constant STRIPE_USE_INTENT_WITH_AUTOMATIC_CONFIRMATION to 1, Dolibarr will use the PaymentIntent Stripe APIs according to the workflow "Automatic Confirmation" (https://stripe.com/docs/payments/payment-intents/quickstart) , which is ready for the SCA.
+*By going to Home - Setup - Other and adding the constant STRIPE_USE_INTENT_WITH_AUTOMATIC_CONFIRMATION to 1, Dolibarr will use the PaymentIntent Stripe APIs according to the workflow "Automatic Confirmation" (https://stripe.com/docs/payments/payment-intents/quickstart) , which is ready for the SCA.
−* By going into Home - Setup - Other and adding the STRIPE_USE_NEW_CHECKOUT constant to 1, Dolibarr will use the CheckOut Stripe APIs according to the "Server Integration" workflow (https://stripe.com/docs/payments/checkout), which is also ready for the SCA.
+*By going into Home - Setup - Other and adding the STRIPE_USE_NEW_CHECKOUT constant to 1, Dolibarr will use the CheckOut Stripe APIs according to the "Server Integration" workflow (https://stripe.com/docs/payments/checkout), which is also ready for the SCA.
When using Dolibarr v11, the default mode is when STRIPE_USE_INTENT_WITH_AUTOMATIC_CONFIRMATION = 1 with no need to change or edit any configuration variable. So if you want to use another method, you must force this constant to 0.
When using Dolibarr v11, the default mode is when STRIPE_USE_INTENT_WITH_AUTOMATIC_CONFIRMATION = 1 with no need to change or edit any configuration variable. So if you want to use another method, you must force this constant to 0.