Validation des adresses des cartes physiques

Comment activer et gérer les fonctionnalités de validation des adresses pour les 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

// Before
"shipping": {
  "address": {
    "line1": "354 Oyster Point Blvd South San Francisco, CA 94080", // incorrectly formatted line1
    "city": "South San Francisco",
    "postal_code": "94080",
    "state": "CA",
    "country": "US"
  }
}

// After
"shipping": {
  "address": {
    "line1": "354 OYSTER POINT BLVD",
    "city": "SOUTH SAN FRANCISCO",
    "postal_code": "94080",
    "state": "CA",
    "country": "US"
  }
}

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

// Before
"shipping": {
  "address": {
    "line1": "354 Oyster Point",
    "city": "South San Francisco",
    "postal_code": "94080",
    "state": "NM", // incorrect state with an available correction
    "country": "US"
  }
}

// After
"shipping": {
  "address": {
    "line1": "354 OYSTER POINT BLVD", // added BLVD suffix
    "city": "SOUTH SAN FRANCISCO",
    "postal_code": "94080",
    "state": "CA", // corrected state
    "country": "US"
  }
}

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

"shipping": {
  // address supplied during card creation
  "address": {
    "line1": "354 Oyster Point Blvd South San Francisco, TX 94080",
    "city": "South San Francisco",
    "postal_code": "94080",
    "state": "TX",
    "country": "US"
  },
  // address validation hash
  "address_validation": {
    // the normalized address
    "normalized_address": {
      "line1": "354 OYSTER POINT BLVD",
      "city": "SOUTH SAN FRANCISCO",
      "state": "CA",
      "postal_code": "94080",
      "country": "US"
    },
    "mode": "validation_and_normalization",
    "result": "likely_deliverable"
  }
}

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.

Résultat	Description
`likely_deliverable`	Si une adresse présentant une correspondance partielle ou totale est trouvée dans notre base de données tierce, votre adresse est considérée comme probablement correcte.
`likely_undeliverable`	Si aucune adresse correspondante ou partiellement correspondante n’est trouvée dans notre base de données tierce, votre adresse est considérée comme probablement incorrecte.
`indeterminate`	Il n’a pas été possible de déterminer si l’adresse était valide.

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

"address_validation": {
  // the normalized address
  "normalized_address": {
    "line1": "354 OYSTER POINT BLVD",
    "city": "SOUTH SAN FRANCISCO",
    "state": "CA",
    "postal_code": "94080",
    "country": "US"
  },
  "mode": "validation_and_normalization",
  // the result showing that address was validated to be likely deliverable
  "result": "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.

Mode	Description
`validation_and_normalization`	Valide et normalise l’adresse de livraison de votre carte avant de l’envoyer. Stripe tente d’appliquer automatiquement les corrections et le formatage appropriés à votre adresse afin de déterminer si elle peut être livrée. En cas de doute concernant la possibilité de livrer la carte à l’adresse indiquée, vous recevez une erreur de requête API.
`normalization_only`	Normalise l’adresse de livraison de votre carte avant de l’envoyer et applique les corrections et le formatage appropriés à votre adresse. La possibilité de livrer votre carte à l’adresse indiquée n’est pas déterminée et vous ne recevez pas d’erreur de requête API.
`disabled`	Expédie votre carte en utilisant l’adresse fournie en l’état, sans la normaliser ni valider la possibilité de livraison. Cette option est uniquement recommandée si l’adresse est réputée correcte ou validée d’une autre manière.

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.

"error": {
  "message": {
    "The address is undeliverable based on given inputs. Please ensure that the address was inputted correctly and can be delivered to."
  }
}

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.

# Example response
{
  "id":  "ic_test1CDR9auHsQKan42gGK34",
  "object": "issuing.card",
  "shipping": {
    // address supplied during card creation
    "address": {
      "line1": "1234 Fake Street",
      "city": "Fake city",
      "postal_code": "94111",
      "state": "NY",
      "country": "US"
    },
    // address validation information
    "address_validation": {
      // the card will be shipped with this address
      "normalized_address": {
        "line1": "1234 FAKE ST",
        "city": "FAKE CITY",
        "state": "NY",
        "postal_code": "94111",
        "country": "US"
      },
      "mode": "normalization_only",
      "result": "likely_undeliverable"
    },
    // other fields...
  },
  // other fields...
}

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.

// Example response
{
  "id":  "ic_test1CDR9auHsQKan42gGK34",
  "object": "issuing.card",
  "shipping": {
    // address supplied during card creation
    "address": {
      "line1": "1234 Fake Street",
      "city": "Fake city",
      "postal_code": "94111",
      "state": "NY",
      "country": "US"
    },
    // address validation information
    "address_validation": {
      "mode": "disabled"
    },
    // other fields...
  },
  // other fields...
}

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.

Validation stricte de l’adresse

Le meilleur moyen d’augmenter le niveau de validité consiste à ne jamais contourner la validation des adresses afin de vous assurer que les clients soumettent toujours des adresses valides.

Suggestions d’adresses

Inviter un utilisateur à choisir entre une adresse suggérée et celle qu’il a fournie est un flux courant que vous pouvez créer vous-même à l’aide de nos fonctionnalités de validation d’adresse.

Validation d’adresse simplifiée

Vous pouvez facilement gérer les erreurs d’adresses non valides en demandant à l’utilisateur de confirmer l’adresse qu’il a soumise. Le mode de validation d’adresse disabled vous permet de vous assurer que vos clients peuvent commander des cartes bancaires sans trop de difficultés si leur adresse est correcte.

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.

Valeur	Type
`address_valid`	Effectuez une requête avec une adresse de livraison de test valide.
`address_invalid`	Effectuez une requête avec une adresse de livraison de test non valide.