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 tunnels et expériences de paiement.
L’API Payment Intents est l’API unifiée pour tous les produits et moyens de paiement Stripe. Bien que nous ne prévoyions pas de retirer Charges, les nouvelles fonctionnalités ne sont disponibles qu’avec 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 bancaires. | 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 bancaires, 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 tunnels 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 depuis 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 :
| Description | Avant | Après |
|---|---|---|
| Informations sur le moyen de paiement utilisé pour créer un paiement | charge. | charge. |
| ID du moyen de paiement utilisé pour le paiement | charge. | charge. |
| Type de moyen de paiement utilisé | charge. (par exemple, card ou bank_) | charge. |
| Informations de facturation pour le paiement (p. ex. code postal) | charge. | charge. |
| Nom du titulaire de la carte | charge. | charge. |
| Les 4 derniers chiffres de la carte utilisée | charge. | charge. |
| Empreinte de la carte | charge. | charge. |
| État de la vérification du CVC pour le paiement | charge. | charge. |
| Marques des cartes bancaires | charge. peut désigner : American Express, Diners Club, Discover, JCB, MasterCard, UnionPayou Visa | charge. peut désigner : amex, diners, discover, jcb, mastercard, unionpayou visa |
| Valeur d’énumération de Google Pay | charge. est android_ | card. dans charge. est google_ |