Accepter un paiement avec Stripe Elements et l'API ChargesAPI Charges
Ancienne API
Le contenu de cette section se rapporte à une fonctionnalité Legacy. Utilisez plutôt l 'API PaymentIntents.
L’API Charges ne prend pas en charge les fonctionnalités suivantes, dont beaucoup sont nécessaires à la conformité d’une carte bancaire :
Utilisez Stripe Elements, nos composants d’interface préconfigurés, pour créer un formulaire de paiement qui vous permet de collecter les informations de carte d’un client en toute sécurité sans manipuler de données sensibles. Les informations de carte sont ensuite transformées en un jeton représentatif que vous pouvez envoyer sans risque à vos serveurs. Votre serveur peut ensuite utiliser ce jeton pour créer un paiement.
Configurer votre compte Stripe
Pour commencer, il vous faut un compte Stripe. Inscrivez-vous.
Utilisez les bibliothèques officielles pour accéder à l’API Stripe à partir de votre application :
Créer votre formulaire de paiementCôté client
Pour collecter les informations des cartes de vos clients en toute sécurité, Elements crée pour vous des composants d’interface hébergés par Stripe. Ces composants sont ensuite placés dans votre formulaire de paiement.
Configurer Stripe Elements
Créer un jetonCôté client
createToken accepte aussi un deuxième paramètre facultatif (qui n’est pas utilisé dans cet exemple) contenant des informations de carte supplémentaires collectées auprès du client. La fonction renvoie un paramètre Promise
qui est résolu avec un objet result
. Cet objet peut renvoyer deux réponses :
result.token
: un jeton a bien été créé.result.error
: une erreur s’est produite. Cela inclut les erreurs de validation côté client. Reportez-vous à la documentation sur les API pour connaître toutes les erreurs possibles.
Si l’objet contient un result.token
, envoyez-le à votre serveur. Sinon, affichez une erreur au client.
Envoyer le jeton à votre serveurCôté client
Envoyez le jeton à votre serveur avec les informations complémentaires collectées :
Créer un paiement avec le jetonCôté serveur
Une fois que le client a publié le jeton sur votre serveur, vous pouvez l’utiliser pour créer un paiement. Sur votre serveur, prenez le jeton Stripe dans les paramètres POST envoyés par votre formulaire. Ensuite, il suffit d’un appel à l’API pour débiter la carte :
La réponse à la création d’un paiement sera soit un paiement soit une erreur avec un code d’erreur. Si la réponse est positive, traitez la commande du client et affichez une page indiquant que son paiement a réussi. Sinon, affichez une page contenant un message d’erreur.
Tester votre intégration
Si vous pouvez saisir le numéro d’une carte de test dans votre formulaire HTML, envoyez-le au serveur et vérifiez qu’il a créé le paiement. Votre intégration est alors terminée.
Félicitations! Vous venez de terminer une intégration de paiement de base avec l’API Charges. Cette API ne prend pas en charge l’expansion des entreprises ou de la clientèle en dehors des États-Unis et du Canada. Pour des paiements plus sûrs à l’international, découvrez comment accepter un paiement avec l’API Payment Intents.
Voir aussi
Vous pouvez en apprendre davantage sur Elements et la manière d’enregistrer des cartes avec l’API Charges.