L'API Charges versus l'API Payment Intents
Découvrez les différences entre les deux principales API de paiement Stripe et quand les utiliser.
Comprendre les API de paiement de Stripe
Il existe actuellement trois moyens d’accepter des paiements sur Stripe :
- Stripe Checkout
- API Charges
- API Payment Intents
Stripe Checkout est une page de paiement préconfigurée vers laquelle vous pouvez rediriger vos clients pour simplifier les achats et les abonnements. Elle offre de nombreuse fonctionnalités, comme Apple Pay, Google Pay, l’internationalisation et la validation de formulaires.
Les API Charges et Payment Intents vous permettent de créer vos flux et expériences de paiement.
L’API Payment Intents regroupe tous les produits et moyens de paiement Stripe. Bien que nous n’abandonnons pas l’API Charges, les nouvelles fonctionnalités sont uniquement proposées sur l’API Payment Intents.
Pour comparer les fonctionnalités, consultez le tableau ci-dessous :
| API Charges | API Payment Intents |
|---|---|
| Utilisée par les entreprises dont la clientèle se situe principalement aux États-Unis et au Canada et qui recherchent un moyen simple d’accepter les cartes. | Obligatoire pour les entreprises qui acceptent divers moyens de paiement et cartes nécessitant une authentification (en vertu par exemple de la réglementation sur l’authentification forte du client en Europe). |
| Compatible avec le Web, iOS et Android. | Compatible avec le Web, iOS et Android. Permet également d’accepter les paiements en magasin avec Terminal. |
| Prend en charge les cartes et tous les moyens de paiement de l’API Sources. | Prend en charge les cartes, les cartes utilisant les prélèvements 3DS, iDEAL, SEPA et de nombreux autres moyens de paiement. |
| N’est pas prête pour la SCA | Est prête pour la SCA |
Migrer le code lisible depuis Charges
Si votre application comporte plusieurs flux de paiement qui sont migrés individuellement de façon incrémentielle de l’API Charges vers l’API Payment Intents, vous devez d’abord mettre à jour tout code lisible à partir de l’objet Charge. Pour vous y aider, l’objet Charge comporte deux propriétés supplémentaires, payment_method_details et billing_details, qui offrent une interface harmonisée permettant de lire l’information sur le moyen de paiement utilisé pour le règlement.
Ces champs sont disponibles sur toutes les versions des API et sur les objets Charge créés avec l’API Charges et l’API Payment Intents.
Le tableau ci-dessous montre les propriétés les plus couramment utilisées pour un paiement et comment accéder à ces informations à l’aide des propriétés supplémentaires :