Cas d'usage pour développer 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 la transaction de solde a été créée. Stripe crée automatiquement cette opération de solde en arrière-plan. L’événement charge.updated inclut une référence à l’opération de solde par la propriété balance_transaction(par exemple, txn_123), ce qui indique que l’opération de solde a été créée et est prête à l’emploi.

Au lieu de rechercher la transaction de solde séparément, vous pouvez la récupérer en un faisant un seul appel à l’aide de l’objet 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 de l’API 2022-08-01 ou d’une version 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 de transactions de solde, que vous pouvez retrouver à l’aide d’une liste des transactions de solde. À partir de cette liste de transactions, vous pouvez développer la propriété source pour réunir des informations sur l’élément qui a déclenché la modification 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 est que les paiements indirects impliquent un transfert et un paiement lié (sous la forme d’un objet Charge) pour transférer les fonds vers un compte connecté. Ainsi, lorsque vous établissez la liste des transactions de solde regroupées dans les virements de votre compte connecté, la source de chaque transaction de solde est liée au paiement du transfert plutôt qu’au paiement d’origine. Pour récupérer ce dernier, vous devez développer le transfert lié d’un paiement au moyen 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