Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous

Calculer les taxes dans vos tunnels de paiement personnalisés.Version bêta privée

Découvrez comment intégrer les taxes avec les API Stripe Tax et Payment Intents.

L’API Stripe Tax vous permet de calculer les taxes dans vos tunnels de paiement personnalisés. Si vous utilisez l’API Payment Intents, Stripe peut transmettre des transactions fiscales dans le cadre du cycle de vie du paiement.

Calculer la taxe

Vous pouvez intégrer l’API Tax à un PaymentIntent en l’associant à un objet Tax Calculation. Utilisez le calcul des taxes pour obtenir un nouvel objet Tax Calculation contenant des informations sur le montant de la taxe à collecter.

Command Line
curl https://api.stripe.com/v1/tax/calculations \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d currency=usd \
  -d "line_items[0][amount]"=1000 \
  -d "line_items[0][reference]"=L1 \
  -d "line_items[0][tax_code]"=txcd_99999999 \
  -d "customer_details[address][line1]"="920 5th Ave" \
  -d "customer_details[address][city]"=Seattle \
  -d "customer_details[address][state]"=WA \
  -d "customer_details[address][postal_code]"=98104 \
  -d "customer_details[address][country]"=US \
  -d "customer_details[address_source]"=shipping

Associer le calcul des taxes au PaymentIntent

Lors de la création ou de la modification d’un PaymentIntent, incorporez l’ID de l’objet Tax Calculation et définissez le paramètre amount sur le amount_total de l’objet Tax Calculation.

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Version: 2024-11-20.acacia; payment_intent_with_tax_api_beta=v1;" \
  -d amount=1000 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]"=true \
  -d "async_workflows[inputs][tax][calculation]"=
{{CALCULATION_ID}}

Endpoints pris en charge

Les endpoints suivants prennent en charge la définition d’un calcul sur un PaymentIntent.

Limitations

  • Vous ne pouvez associer de nouveaux calculs à un PaymentIntent que jusqu’à ce qu’il passe à l’état succeeded.
  • Un calcul de taxe ne peut donner lieu qu’à une seule Transaction. Si plusieurs PaymentIntents passent à un état succeeded avec le même calcul lié, la comptabilité ne reflète que le premier.

Mesures prises par Stripe en conséquence

Si le PaymentIntent est correctement associé à l’objet Tax Calculation, Stripe procède automatiquement :

  • à la création d’une transaction fiscale à partir du calcul une fois que le PaymentIntent passe à l’état succeeded
  • Procède à l’annulation de la taxe applicable à une transaction fiscale en cas de remboursement (créés avec l’API ou le Dashboard) lié au PaymentIntent
  • à la création d’une annulation de la taxe en cas d’annulation, si un remboursement n’a pas abouti
  • Comprend les informations fiscales totales dans les reçus PaymentIntent

Stripe :

  • ne modifiera pas le montant du PaymentIntent en fonction du calcul de taxe associé
  • ne modifiera pas le montant de la transaction fiscale en fonction du montant capturé dans le PaymentIntent
  • ne créera automatiquement aucune annulation de taxe en cas de litige

Voir aussi

Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service d'assistance.
Rejoignez notre programme d'accès anticipé.
Consultez notre journal des modifications des produits.
Des questions ? Contactez l'équipe commerciale.
Propulsé par Markdoc
Sur cette page
Calculer la taxe
Associer le calcul des taxes au PaymentIntent
Endpoints pris en charge
Limitations
Mesures prises par Stripe en conséquence
Voir aussi
Produits utilisés
Tax
Payments