Cas d'usage pour développer des réponses

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

Parfois, vous pouvez avoir besoin de vérifier les frais de traitement pour un paiement. Ces frais ne sont visibles qu’une fois le paiement effectué et la transaction de solde créee. Cette transaction de solde est créée automatiquement en arrière-plan, et l’événement charge.updated indiquera les frais.

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_4eC39HqLyjWDarjtT1zdp7dc
: \
  -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_4eC39HqLyjWDarjtT1zdp7dc
: \
  -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_4eC39HqLyjWDarjtT1zdp7dc
: \
  -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_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d payout=po_1G7bnaD2wdkPsFGzdVOqU44u \
  -d type=payment \
  -d "expand[]"="data.source.source_transfer.source_transaction" \
  -H "Stripe-Account: acct_1G7PaoD2wdkPsFGz" \
  -G