Accepter un paiement avec Stripe Elements et l'API ChargesAPI Charges
Acceptez les paiements en ligne de clients américains et canadiens.
Ancienne API
The content of this section refers to a Legacy feature. Use the Payment Intents API instead.
L’API Charges ne prend pas en charge les fonctionnalités suivantes, dont beaucoup sont nécessaires à la conformité d’une carte bancaire :
- Marchands en Inde
- Bank requests for card authentication
- Strong Customer Authentication
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 gérer de données sensibles. Les informations de carte sont ensuite transformées en 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) qui contient 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 ce qui suit :
result.
: un jeton a bien été créé.token result.
: une erreur s’est produite. Cela comprend les erreurs de validation côté client. Consultez la documentation sur les API pour connaître toutes les erreurs possibles.error
Si l’objet contient un result.
, 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 faites afficher une page indiquant que son paiement a été effectué. Sinon, faites afficher 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.