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

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

Il peut arriver que vous souhaitiez consulter les frais de traitement d’un paiement. Vous ne pouvez voir ces frais Stripe qu’une fois que le paiement a été effectué et que la transaction de solde a été créée. Cette opération sur solde est automatiquement créée en arrière-plan, et l’événement charge.updated affiche les frais.

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