Cas d'utilisation pour le développement des réponses

Consulter les frais appliqués par Stripe pour un paiement donné

Vous pouvez vérifier les frais de traitement d’un paiement une fois que le paiement a été traité et que l’opération sur solde a été créée. Stripe crée automatiquement cette opération sur solde en arrière-plan. L’événement charge.updated inclut une référence à l’opération sur solde par la propriété balance_transaction(par exemple, txn_123), indiquant que l’opération sur solde a été créée et est prête à l’emploi.

Au lieu de rechercher l’opération sur solde séparément, vous pouvez la récupérer en un seul appel à l’aide expand. Par exemple :

curl https://api.stripe.com/v1/payment_intents/pi_1Gpl8kLHughnNhxyIb1RvRTu \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "expand[]"="latest_charge.balance_transaction" \
  -G

Utilisateurs de la version du 01/08/2022 de l’API ou une version ou antérieure :

curl https://api.stripe.com/v1/payment_intents/pi_1Gpl8kLHughnNhxyIb1RvRTu \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "expand[]"="charges.data.balance_transaction" \
  -G

Consulter les frais inclus dans un virement

Chaque virement automatique est lié à des modifications historiques du solde de votre compte Stripe. L’API enregistre ces modifications sous forme d’opérations sur solde, que vous pouvez retrouver à l’aide d’une liste des opérations sur solde. Depuis cette liste d’opérations, vous pouvez développer la propriété source pour réunir des informations sur l’élément ayant abouti à l’évolution du solde du compte (paiement, remboursement, transfert, etc.). Par exemple :

curl https://api.stripe.com/v1/balance_transactions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d payout=po_1Gl3ZLLHughnNhxyDrOia0vI \
  -d type=charge \
  -d "expand[]"="data.source" \
  -G

En savoir plus sur le rapprochement des virements.

Si vous utilisez Connect avec des paiements indirects, vous pouvez récupérer les mêmes informations au nom de vos comptes connectés. Une différence toutefois : les paiements indirects concernent à la fois un transfert et un paiement lié (sous la forme d’un objet Charge) pour déplacer les fonds vers un compte connecté. Ainsi, lorsque vous répertoriez les opérations sur solde regroupées dans les virements de votre compte connecté, la source de chaque opération sur solde est liée au paiement du transfert plutôt qu’au paiement d’origine. Pour récupérer celui-ci, vous devez développer le transfert lié d’un paiement par le biais de la propriété source_transfer, puis la propriété source_transaction du transfert :

curl https://api.stripe.com/v1/balance_transactions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d payout=po_1G7bnaD2wdkPsFGzdVOqU44u \
  -d type=payment \
  -d "expand[]"="data.source.source_transfer.source_transaction" \
  -H "Stripe-Account: acct_1G7PaoD2wdkPsFGz" \
  -G