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.
• Écouter les événements webhook pour les abonnements, car la plupart des activités se déroulent de manière asynchrone.

Erreurs de finalisation de la facture

Une localisation client reconnue est nécessaire pour finaliser les factures avec Stripe Tax. Les informations concernant la localisation peuvent manquer ou ne pas être valables si vous modifiez ou supprimez le moyen de paiement par défaut d’un client, ou si vous n’avez pas fourni tax[validate_location]="immediately" lors de la création ou de la mise à jour d’un client.

Si nous ne disposons pas d’une localisation client reconnue, les factures pour un abonnement continuent à être finalisées automatiquement mais sans calculer les taxes, ce qui produit les effets suivants :

• Le paramètre automatic_tax[enabled] passe à l’état false sur l’abonnement et la facture.
• Le paramètre Invoice[automatic_tax][disabled_reason] devient finalization_requires_location_inputs.
• Le paramètre Subscription[automatic_tax][disabled_reason] devient requires_location_inputs.
• Si l’abonnement est assorti d’une planification, nous attribuons la valeur false à automatic_tax[enabled] dans la phase actuelle et dans default_settings. Dans les deux cas, nous attribuons à disabled_reason la valeur requires_location_inputs.
• Nous envoyons des événements invoice.updated et customer.subscription.updated pour informer votre intégration de ces modifications.
  • S’il y a une planification, nous envoyons également un webhook subscription_schedule.updated.
• La facture est finalisée sans calcul ni perception de taxes. Elle ne contiendra aucun montant de taxe.
• Nous percevons le paiement comme d’habitude selon le mode de recouvrement de la facture.

Pour consulter les abonnements sans calcul automatique de la taxe dans votre Dashboard Stripe, accédez à votre page Abonnements et filtrez l’affichage par l’option Taxe automatique non activée. Pour réactiver la taxe automatique pour ces abonnements à l’avenir, assurez-vous d’avoir au moins une localisation client valide, et activez la taxe automatique via le Dashboard Stripe Tax.

Exceptions à la désactivation automatique de la taxe

Stripe renvoie une erreur et laisse la facture à l’état draft lors de la finalisation avec l’API ou le Dashboard sans une localisation client valide. Dans l’API, une erreur HTTP 400 est renvoyée avec un code de customer_tax_location_invalid.

De même, pour la finalisation automatique des factures autonomes sans abonnement, la facture reste à l’état de projet si la localisation client n’est pas valide. Nous envoyons un événement invoice.finalization_failed avec l’attribut customer_tax_location_invalid comme last_finalization_error[code] de la facture.

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.