Accepter un paiement avec Stripe Elements et l'API ChargesAPI Charges
Accepter 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 :
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 converties en un token représentatif que vous pouvez envoyer sans risque à vos serveurs. Votre serveur peut ensuite utiliser ce token pour créer un paiement.
Configurer 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éez 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.
Configurez Stripe Elements
Créez un tokenCô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.
: un Token a bien été créé.token result.
: une erreur s’est produite. Cela inclut les erreurs de validation côté client. Reportez-vous à la documentation relative à l’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.
Envoyez le token à votre serveurCôté client
Envoyez le token à votre serveur avec les informations complémentaires collectées :
Créez un paiement avec le tokenCôté serveur
Une fois que le client a publié le token sur votre serveur, vous pouvez l’utiliser pour créer un paiement. Sur votre serveur, prenez le token Stripe dans les paramètres POST envoyés par votre formulaire. Ensuite, il suffit d’un appel d’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 abouti. Sinon, affichez une page contenant un message d’erreur.
Tester votre intégration
Si vous pouvez saisir le numéro d’une carte 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 avez créé une intégration de paiement de base avec l’API Charges. Cette API ne prend pas en charge la croissance des entreprises ou clients établis en dehors des États-Unis et du Canada. Pour des paiements plus sûrs à l’échelle mondiale, 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.