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 à l’API pour récupérer des 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 les plus 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. L’événement 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.

Remarques

Les utilisateurs bénéficiant du prix coûtant majoré 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.

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

Remarques

Un Payment Intent doit être capturé et avoir l’état succeeded pour que les frais Stripe soient disponibles.

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 :

Remarques

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.

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 :