Transmettre des coordonnées de carte bancaire à votre propre système de stockage des tokens
Découvrez comment ajouter des coordonnées de carte bancaire enregistrées sur Stripe à votre système de stockage des tokens.
Créez un PaymentMethod et transmettez le moyen de paiement à votre système de stockage des tokens.
Demander un accès
Pour obtenir un accès au service de transfert de Stripe, contactez le service d’assistance Stripe.
Créer un PaymentMethod![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Pour collecter les informations de carte et les envoyer à Stripe en vue de les utiliser avec l’API Vault and Forward, utilisez le composant Payment Element afin de créer un PaymentMethod. Une fois que vous avez créé un PaymentMethod, nous stockons automatiquement les informations de la carte dans le système sécurisé de Stripe, conforme aux normes PCI. Si vous avez votre propre front-end, vous pouvez toujours utiliser l’API Vault and Forward en créant directement un PaymentMethod.
Créer une ForwardingRequest![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Transmettez l’ID du moyen de paiement à l’endpoint Request sur votre serveur. Stripe fournit un endpoint de test (https://forwarding-api-demo.
) et un moyen de paiement de test (pm_
) pour vérifier que vous pouvez récupérer les informations d’identification de la carte à partir du système de stockage de Stripe. Envoyez les informations de carte à cet endpoint de test avant de connecter votre intégration à votre système de stockage interne.
Configurer votre endpoint de stockage interne des tokens![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Pour recevoir des numéros de compte principaux (PAN) de l’API Vauld and Forward, votre système de stockage des tokens doit être conforme aux spécifications suivantes.
Conformité PCI![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Vérifiez que votre système de stockage est conforme à la norme PCI et fournissez une attestation de conformité PCI valide au service d’assistance Stripe. Vous devez renouveler cette attestation chaque année.
Exigences de l’API![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Votre système de stockage doit contenir des API HTTPS qui acceptent le format JSON et renvoient des réponses JSON. Les autres formats, comme XML ou ISO 8583, ne sont pas pris en charge.
Assurez-vous que l’API contient une URL statique unique. Pour des raisons de sécurité, configurez-la dans l’API Vault and Forward. Ne la modifiez pas entre les requêtes.
Authentification![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Utilisez l’API Vault and Forward pour vous identifier auprès de votre stockage sécurisé à l’aide de schémas d’authentification basés sur l’en-tête HTTP, y compris les tokens au porteur.
Assurez-vous que chaque appel à l’API transféré inclut l’en-tête d’authentification permettant de vous authentifier auprès de votre système de stockage.
Nous ne prenons pas en charge l’authentification par certificat client.
En-têtes de requête![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Vous pouvez inclure des en-têtes supplémentaires dans la requête transmise à votre système de stockage. Cependant, vous devez vérifier que la configuration de système de stockage prend explicitement en charge ces en-têtes. Contactez le service d’assistance Stripe avant de commencer votre intégration pour vérifier que les en-têtes supplémentaires requis sont correctement configurés. En outre, assurez-vous que les en-têtes n’incluent pas d’informations sensibles, à l’exception du token du porteur.
Corps de requête![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Vérifiez que votre système de stockage reçoit un objet JSON au format suivant.
{ "card": { "number": "4242424242424242", "exp_month": "12", "exp_year": "2023", "name": "John Doe", "cvc": "123" }, "metadata": { // Put your additional fields here } }
Si nécessaire, votre requête peut inclure des champs supplémentaires sous la clé de métadonnées. Nous les transmettons sans traitement supplémentaire.
L’API Vault and Forward place les données déchiffrées dans les champs suivants :
Nom du champ | Type | Description |
---|---|---|
number | Chaîne | Le numéro PAN à 15 ou 16 chiffres de la carte bancaire |
exp_ | Chaîne | Le mois d’expiration de la carte bancaire |
exp_ | Chaîne | L’année d’expiration de la carte bancaire, en quatre chiffres |
name | Chaîne | Le nom du titulaire de la carte |
cvc | Chaîne | La valeur de vérification de la carte bancaire. Celle-ci n’est disponible que pour la première requête API à Stripe suivant la tokenisation. Nous supprimons cette information de notre système après un court laps de temps. Ne stockez pas cette valeur. |
Votre système de stockage n’a pas besoin de prendre en charge tous ces champs. L’API Vault and Forward place les valeurs dans la requête uniquement si elles sont présentes dans le corps de la requête que vous envoyez à l’API Vault and Forward. En outre, vous pouvez inclure des champs supplémentaires dans le corps de la requête, que l’API Vault and Forward transmet à l’endpoint de destination.
Corps de réponse![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
L’API Vault and Forward n’exige pas de corps de réponse de la part de votre coffre-fort. Si vous fournissez un corps de réponse, nous le renvoyons à l’appelant de l’API Vault and Forward. N’incluez pas de champs sensibles dans votre réponse.
Codes de réponse![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
L’API Vault and Forward traite toute réponse comme une réussite et renvoie à l’appelant le même code de réponse que celui envoyé par l’endpoint de stockage des tokens à Stripe. Par exemple, lorsque le point d’accès en amont renvoie un code d’état 400
à Stripe, l’API Vault and Forward répond avec un code d’état 200
. Le corps de la réponse contient la réponse 400
du premier et le message d’erreur.
Vérifier l'intégration à votre système de stockage des tokens![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Pour confirmer la fonctionnalité correcte de votre intégration avec l’endpoint de stockage, remplacez l’endpoint de Stripe par votre configuration de stockage. Ensuite, lancez une ForwardingRequest en utilisant le PaymentMethod que vous avez créé.
Mettre à jour votre système de stockage des tokens avec les derniers identifiants![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Écoutez les webhooks Stripe pour savoir si une carte a été mise à jour. Appelez l’API Vault and Forward pour transmettre le PaymentMethod mis à jour à votre stockage sécurisé de tokens.