Accéder directement au contenu
Créez un compte
ou
connecter-vous
Logo de la documentation Stripe
/
Ask AI
Créez un compte
Connectez-vous
Démarrer
Paiements
Automatisation des opérations financières
Plateformes et places de marché
Gestion de fonds
Outils de développement
Démarrer
Paiements
Automatisation des opérations financières
Démarrer
Paiements
Automatisation des opérations financières
Plateformes et places de marché
Gestion de fonds

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.

Copier la page

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.

Version bêta privée

Cette fonctionnalité est actuellement en version bêta privée. Les utilisateurs qui ne disposent pas d’un accès à cette version peuvent utiliser l’API Tax pour intégrer Stripe Tax avec les Payment Intents.

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
curl https://api.stripe.com/v1/tax/calculations \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -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

Version bêta privée

Cette fonctionnalité est actuellement en version bêta privée. Les utilisateurs qui ne disposent pas d’un accès à cette version peuvent utiliser l’API Tax pour intégrer Stripe Tax avec les Payment Intents.

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
curl https://api.stripe.com/v1/payment_intents \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Version: 2025-04-30.basil; 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.

  • Création : /v1/payment_intents
  • Mise à jour : /v1/payment_intents/:id
  • Confirmation : /v1/payment_intents/:id/confirm
  • Capture : /v1/payment_intents/:id/capture

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.

Actions Stripe résultantes

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

Intégrer les taxes pour votre plateforme Connect avec les API Stripe Tax et Payment Intents

L’API Payment Intents fonctionne avec les comptes connectés sur votre plateforme Connect. Par conséquent, si vous calculez la taxe à l’aide d’un compte connecté, vous pouvez lier le calcul de la taxe à un Payment Intent créé à l’aide de ce compte connecté.

FacultatifRécupérer les transactions fiscales engagées automatiquement

Voir aussi

  • API Tax pour les taxes sur les ventes, la TPS et la TVA
  • Guide sur les tunnels de paiement personnalisés
  • Déclarations fiscales
  • Utiliser Stripe Tax avec Connect
Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc
Guides connexes
Stripe Tax avec Payment Links
Stripe Tax avec Checkout
Stripe Tax avec Invoicing
Stripe Tax avec des flux de paiement personnalisés
Produits utilisés
Tax
Payments