# Cas d'usage pour développer des réponses Développez les réponses de l’API pour renvoyer les informations de paiement courantes. Utilisez le paramètre `expand` dans votre requête API pour récupérer les détails que l’API ne renvoie pas dans sa réponse par défaut. Les cas d’usage suivants illustrent cela pour les informations couramment demandées. ## Consulter les frais appliqués par Stripe pour un paiement donné Vous pouvez consulter les frais de traitement d’un paiement une fois que le paiement a été traité et que Stripe a créé l’[opération sur solde](https://docs.stripe.com/api/balance_transactions/object.md#balance_transaction_object-fee_details). L’événement [charge.updated](https://docs.stripe.com/api/events/types.md#event_types-charge.updated) fait référence à la propriété `balance_transaction` (par exemple, `txn_123`), ce qui indique qu’elle 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 de l’objet `expand`. > *Les utilisateurs bénéficiant du prix coûtant majoré* (A pricing plan where businesses pay the variable network cost for each transaction plus the Stripe fee rather than a flat rate for all transactions. This pricing model provides more visibility into payments costs) ne peuvent pas récupérer les informations sur les frais de paiement à partir de l’opération sur solde. Utilisez plutôt le rapport sur les frais de paiement. #### curl ```bash curl https://api.stripe.com/v1/payment_intents/pi_1Gpl8kLHughnNhxyIb1RvRTu \ -u <>: \-d "expand[]"="latest_charge.balance_transaction" \ -G ``` Utilisateurs de la version de l’API [2022-08-01](https://docs.stripe.com/upgrades.md#2022-08-01) ou d’une version antérieure : #### curl ```bash curl https://api.stripe.com/v1/payment_intents/pi_1Gpl8kLHughnNhxyIb1RvRTu \ -u <>: \-d "expand[]"="charges.data.balance_transaction" \ -G ``` > Un PaymentIntent doit être [capturé](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md#capture-funds) et avoir l’[état](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-status) `succeeded` pour que les frais Stripe soient disponibles. Lors de l’utilisation de `automatic_async` (la `capture_method` par défaut depuis la version `2024-04-10`), les opérations sur solde sont créées après le succès du paiement, mais de manière asynchrone en arrière-plan. Cela signifie : - Le champ `balance_transaction` sur l’objet Charge peut être `null` immédiatement après la confirmation - Si vous développez `balance_transaction` ou `latest_charge.balance_transaction`, il se peut qu’il ne soit pas disponible dans la réponse. - Vous pouvez écouter l’événement `charge.updated` pour savoir quand l’opération sur solde devient disponible Ce comportement asynchrone améliore les performances en matière de paiement, mais nécessite que votre intégration gère la possibilité que l’opération sur solde ne soit pas immédiatement disponible. ## Consulter les frais inclus dans un virement Chaque *virement* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) automatique est lié à des modifications historiques du solde de votre compte Stripe. L’API enregistre ces modifications sous forme de [transactions de solde](https://docs.stripe.com/api/balance_transactions/object.md), que vous pouvez retrouver à l’aide d’une [liste des transactions de solde](https://docs.stripe.com/api/balance_transactions/list.md). À partir de cette liste de transactions, vous pouvez développer la propriété [source](https://docs.stripe.com/api/balance_transactions/object.md#balance_transaction_object-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 ```bash curl https://api.stripe.com/v1/balance_transactions \ -u <>: \ -d payout=po_1Gl3ZLLHughnNhxyDrOia0vI \ -d type=charge \-d "expand[]"="data.source" \ -G ``` > Vous ne pouvez récupérer l’historique des opérations sur solde que sur les virements *automatiques*. Si les virements manuels sont activés, vous devez suivre vous-même l’historique des opérations. En savoir plus sur le [rapprochement des virements](https://docs.stripe.com/payouts/reconciliation.md). Si vous utilisez *Connect* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients) 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](https://docs.stripe.com/api/charges/object.md#charge_object-source_transfer), puis la propriété [source_transaction](https://docs.stripe.com/api/transfers/object.md#transfer_object-source_transaction) du transfert : #### curl ```bash curl https://api.stripe.com/v1/balance_transactions \ -u <>: \ -d payout=po_1G7bnaD2wdkPsFGzdVOqU44u \ -d type=payment \-d "expand[]"="data.source.source_transfer.source_transaction" \ -H "Stripe-Account: acct_1G7PaoD2wdkPsFGz" \ -G ```