Collecter les adresses des clients

Stripe Tax doit accéder à la localisation de votre client pour calculer automatiquement la taxe. Cette exigence s’applique même si vous n’avez pas d’immatriculation active. Ce guide vous aide à comprendre comment collecter les adresses de vos clients.

Checkout et Payment Links

Checkout gère pour vous la collecte des adresses des clients, y compris celles créées par Payment Links.

Invoicing, Subscriptions et intégrations de paiements personnalisées

Si vous n’utilisez ni Payment Links ni Checkout, vous êtes responsable de la collecte des adresses des clients.

• Collectez et définissez les champs country et postal_code sur vos objets Customer.
• Utilisez des codes de pays à deux lettres (ISO 3166-1 alpha-2).
• Lors de la création ou de la mise à jour d’un client, définissez tax[validate_location]=“immediately” pour éviter de rencontrer des erreurs customer_tax_location_invalid par la suite.
• Écoutez les événements de webhook relatifs aux abonnements, car la plupart des activités se déroulent de manière asynchrone.

Erreurs de finalisation de la facture

Lorsque nous ne pouvons pas finaliser une facture en raison d’une localisation client non reconnue, nous envoyons un événement invoice.finalization_failed avec l’attribut customer_tax_location_invalid comme last_finalization_error[code] de facture. Cela peut se produire si vous n’avez pas indiqué tax[validate_location]="immediately" lors de la création ou de la mise à jour d’un client.

La façon de corriger une erreur customer_tax_location_invalid dépend de si vous avez ou pouvez collecter l’adresse d’un client.

• Si vous disposez d’une adresse client ou si vous pouvez la collecter, mettez le client à jour et finalisez la facture manuellement.
  1. Mettez à jour le client avec tax[validate_location]=“immediately” pour vous assurer que la nouvelle adresse est valide.
  2. Finalisez la facture.
• Si vous ne connaissez pas l’adresse d’un client ou si vous ne pouvez pas la collecter, désactivez Stripe Tax pour la facture et son abonnement et finalisez la facture manuellement.
  1. Mettez à jour la facture concernée avec automatic_tax[enabled]=false.
  2. Mettez à jour l’abonnement concerné avec automatic_tax[enabled]=false.
  3. Finalisez la facture.