Utiliser l'API Settings pour configurer Stripe Tax

Vérifiez si tout est prêt pour utiliser Stripe Tax

Effectuez cette vérification pour déterminer si Stripe Tax peut être activé. Utilisez nos bibliothèques officielles pour accéder à l’API Stripe. Récupérer l’objet tax.settings :

curl https://api.stripe.com/v1/tax/settings \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Vous pouvez également écouter l’événement de webhook tax.settings.updated qui se déclenche lorsque vous mettez à jour les paramètres fiscaux depuis le Dashboard Stripe ou lorsque de nouveaux paramètres fiscaux requis sont introduits. Consultez la page Faire passer les webhooks en production pour savoir comment ajouter un endpoint de webhook.

Vous pouvez commencer à utiliser Stripe Tax si l’objet de réponse tax.settings récupéré par l’API ou l’événement de webhook renvoie le status "active". Les paramètres defaults.tax_code et defaults.tax_behavior ne sont requis que s’ils ne sont pas indiqués dans le produit ou le prix à chaque appel à l’API.

{
  "object": "tax.settings",
  "defaults": {
    "tax_code": null,
    "tax_behavior": null
  },
  "head_office": {
    "address": {
      "country": "DE"
    }
  },
  "livemode": false,
  "status": "active",
  "status_details": {
    "active": {}
  }
}

Vous ne pouvez pas commencer à utiliser Stripe Tax si la réponse de l’objet tax.settings renvoie le status "pending". status_details[pending][missing_fields] contient la liste de tous les champs manquants requis.

{
  "object": "tax.settings",
  "defaults": {
    "tax_code": null,
    "tax_behavior": null
  },
  "head_office": null,
  "livemode": false,
  "status": "pending",
  "status_details": {
    "pending": {
      "missing_fields": ["head_office"]
    }
  }
}

Configurer vos paramètres

Effectuez cette étape lorsque vous gérez toute la configuration de Stripe Tax via votre propre interface.

Vous pouvez modifier les paramètres via un appel de modification des paramètres. Effectuez un appel en indiquant le siège social de l’entreprise, le code de taxe par défaut et le régime de taxe.

curl https://api.stripe.com/v1/tax/settings \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "defaults[tax_code]"=txcd_10000000 \
  -d "defaults[tax_behavior]"=inclusive \
  -d "head_office[address][country]"=DE

L’objet tax.settings mis à jour comporte désormais un siège social, un code de taxe et un régime de taxe par défaut, ce qui vous permet d’activer Stripe Tax.

{
  "object": "tax.settings",
  "defaults": {
    "tax_code": "txcd_10000000",
    "tax_behavior": "inclusive"
  },
  "head_office": {
    "address": {
      "country": "DE"
    }
  },
  "livemode": false,
  "status": "active",
  "status_details": {
    "active": {}
  }
}

Validations et erreurs

Les codes de taxe doivent correspondre aux codes de taxe disponibles et le comportement fiscal doit être défini sur inclusive, exclusive ou inferred_by_currency (une fois défini, il ne peut plus être défini sur null). Le head_office doit inclure une adresse prise en charge.

La head_office[address] possède les champs line1, line2, city, state, postal_code et country. Les tableaux ci-dessous décrivent les formats d’adresse pris en charge.

Utilisez l’un des formats d’adresse ci-dessus pour nous permettre de reconnaître systématiquement le siège social de votre entreprise. Le champ du pays doit toujours correspondre à un code pays ISO valide.