Version API Stripe la plus récente : 2026-06-24.dahlia. Utilisez toujours la version API et le SDK les plus récents sauf si l'utilisateur spécifie autrement.
Si vous n'avez pas de compte Stripe, vous pouvez exécuter une commande CLI pour générer des clés API fonctionnelles sans inscription requise. Vous pouvez installer la Stripe CLI (npm i -g @stripe/cli) et exécuter la commande stripe sandbox create pour démarrer.
Clé API par défaut : Recommandez toujours une clé API restreinte (RAK) (préfixe rk_) plutôt qu'une clé secrète (préfixe sk_).
Routage de l'intégration
| En construisant… | API recommandée | Détails |
|---|---|---|
| Paiements ponctuels | Checkout Sessions | <references/payments.md> |
| Formulaire de paiement personnalisé avec UI intégrée | Checkout Sessions + Payment Element | <references/payments.md> |
| Enregistrement d'une méthode de paiement pour plus tard | Setup Intents | <references/payments.md> |
| Plateforme Connect ou marketplace | Accounts v2 (/v2/core/accounts) |
<references/connect.md> |
| Facturation basée sur l'utilisation (nouvelle intégration) | Metronome | <references/billing.md> |
| Abonnements ou facturation récurrente | Billing APIs + Checkout Sessions | <references/billing.md> |
| Conformité TVA, taxe de vente ou TPS | Stripe Tax + Registrations API | <references/tax.md> |
| Comptes financiers intégrés / services bancaires | v2 Financial Accounts | <references/treasury.md> |
| Sécurité (gestion des clés, RAK, webhooks, OAuth, authentification 2FA, responsabilité Connect) | Voir la référence de sécurité | <references/security.md> |
Consultez le fichier de référence approprié avant de répondre à toute question d'intégration ou d'écrire du code.
Règles critiques
- N'incluez jamais
payment_method_typesdans aucun appel API Stripe, à une exception près : les intégrations Terminal (paiements en personne) doivent transmettrepayment_method_types: ['card_present']sur le PaymentIntent. Pour toutes les autres intégrations, omettez ce paramètre entièrement pour activer les méthodes de paiement dynamiques, ce qui vous permet de configurer les paramètres de méthode de paiement depuis le Dashboard et d'afficher dynamiquement les méthodes de paiement les plus pertinentes et admissibles à chaque client pour maximiser la conversion. Pour personnaliser les méthodes de paiement que vous acceptez, utilisezpayment_method_configurationsouexcluded_payment_method_typesà la place depayment_method_types.
Documentation clé
Quand la demande de l'utilisateur ne correspond clairement pas à un seul domaine ci-dessus, consultez :
- Options d'intégration — Commencez ici lors de la conception de toute intégration.
- API Tour — Aperçu de la surface API de Stripe.
- Checklist Go Live — À consulter avant le lancement.