Validation des adresses des cartes physiques

Stripe Issuing a besoin d’adresses de livraison précises et correctement formatées pour garantir la livraison des cartes physiques à leurs destinataires. Les cartes envoyées à des adresses invalides sont renvoyées à Stripe, mais la tentative de livraison et le retour éventuel peuvent prendre plus de deux semaines. Les cartes renvoyées peuvent créer une contrainte opérationnelle, augmenter vos coûts globaux et retarder la réception des cartes physiques par vos titulaires de carte.

Pour faire en sorte que vos livraisons arrivent à bon port, l’API Cards de Stripe propose une fonction intégrée de formatage et de validation des adresses. Stripe compare l’adresse de livraison fournie à une base de données d’adresses tierce et identifie ou résout tout problème lié à l’adresse.

Normalisation des adresses

Cette standardisation assure la conformité de vos adresses aux normes du pays d’expédition, tout en rectifiant les erreurs d’adresse manifestes.

Voici quelques exemples de formatage :

Formatage des adresses pour garantir une mise en forme adéquate

Correction d’adresse pour appliquer les corrections détectées issues d’une adresse validée existante

L’adresse formatée est incluse dans le hash de validation de l’adresse, renvoyé après la création réussie d’une carte physique ou la mise à jour de l’adresse de livraison d’une carte en activant le formatage de l’adresse.

Exemple de validation d’adresse

Validation des adresses

La validation détermine si votre adresse est correcte en tentant de la faire correspondre à une adresse existante et validée. Cette étape a lieu après le processus de formatage.

Le résultat de cette validation est inclus dans le hash de validation d’adresse. En fonction du mode de validation d’adresse utilisé, une erreur d’API peut se produire.

Par exemple, l’exemple précédent montrait le résultat de validation likely_deliverable.

Gestion des fonctionnalités de validation d’adresse avec les modes de validation d’adresse

L’API Cards prend en charge trois modes de validation d’adresse, qui peuvent être spécifiés de manière facultative dans le paramètre address_validation lors de la création d’une carte physique ou de la mise à jour de l’envoi d’une carte.

Utiliser validation_and_normalization pour le mode de validation des adresses. Nous proposons également d’autres modes en fonction de votre scénario :

• disabled : si vous pensez qu’une carte a été bloquée à tort.
• normalization only : si vous souhaitez minimiser les erreurs API tout en bénéficiant des avantages de la normalisation. Si elle n’est pas spécifiée, la valeur par défaut est normalization_only.

Validation et formatage

Votre carte est expédiée avec l’adresse formatée et validée. L’adresse est vérifiée et l’API renvoie une erreur si l’adresse est susceptible d’être incorrecte. Stripe recommande vivement d’utiliser ce mode pour garantir que les adresses saisies sont correctes.

Formatage uniquement

Votre carte sera expédiée à l’adresse formatée. La vérification de la validité de l’adresse n’est pas appliquée, et vous ne recevez pas d’erreur de la part de l’API si l’adresse est susceptible d’être incorrecte.

Désactivation

Ce mode permet l’expédition de votre carte en utilisant l’adresse fournie en l’état, sans la formater ni vérifier qu’elle est correcte. Aucune adresse formatée ni résultat de validation ne seront renvoyés. Cette option est uniquement recommandée si l’on sait que l’adresse est correcte ou qu’elle a été validée d’une autre manière.

Intégration de la validation d’adresse dans votre flux de création de carte bancaire

Vous trouverez ci-dessous des exemples expliquant comment intégrer des fonctionnalités de validation d’adresse à votre flux. Ces exemples ne sont pas exhaustifs et sont uniquement destinés à vous aider dans votre intégration.

Test de la validation d’adresse

Vous pouvez fournir une valeur pour line1 afin de déclencher certaines conditions de validation en mode test. Vous devez transmettre des valeurs valides pour les arguments city, state et postal_code.