Transfert de fonds avec Treasury à l'aide d'objets ReceivedCredit
Comment transférer des fonds vers un compte financier Treasury depuis un autre compte financier Treasury ou un autre compte bancaire.
Lorsque des fonds sont transférés vers un compte financier, Stripe crée un objet ReceivedCredit correspondant sur le compte. Un ReceivedCredit
contient des informations sur la façon dont les fonds ont été envoyés et, dans la mesure du possible, sur l’expéditeur. Vous pouvez envoyer des fonds vers un compte financier à l’aide des numéros de routage et de compte pour les transferts ach
et us_
, ou de l’ID du compte financier pour les transferts entre deux comptes financiers.
Lorsque les fonds proviennent d’un autre compte financier Treasury, le ReceivedCredit
contient une référence linked_
à l’origine du mouvement de fonds. Dans ce cas, le paramètre network
de l’OutboundPayment
source prend la valeur stripe
.
Récupérer un ReceivedCredit![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Utilisez GET /v1/treasury/received_
pour récupérer l’objet ReceivedCredit avec l’ID indiqué.
La requête suivante permet de récupérer le ReceivedCredit
avec l’ID spécifié. La réponse à cette requête inclut les informations développées relatives à l’objet Transaction.
Sauf échec de l’opération, la réponse renvoie l’objet ReceivedCredit
demandé. Certains des paramètres de la réponse comportent des informations supplémentaires qui ne sont renvoyées que si vous les ajoutez comme valeurs au paramètre expand[]
de votre demande. Les champs que vous pouvez développer affichent le commentaire Expandable
, comme illustré dans l’exemple de réponse suivant. Pour en savoir plus sur le développement des objets renvoyés, consultez la section sur le développement des réponses.
Lister des ReceivedCredits![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Utilisez GET /v1/treasury/received_
pour récupérer tous les ReceivedCredits
du compte financier avec l’ID du paramètre obligatoire financial_
. Vous pouvez filtrer la liste en utilisant les paramètres de liste standard, par status
ou linked_
.
{ // Standard list parameters "limit", "starting_after", "ending_before", // Filter by FinancialAccount (required) "financial_account": "{{FINANCIAL_ACCOUNT_ID}}", // Filter by status "status": "succeeded" | "failed", // Filter by `source_flow_type` "linked_flows.source_flow_type": nil | "payout" | "outbound_payment" }
Dans la requête suivante, les ReceivedCredits
qui présentent un état failed
sont récupérés sur le compte financier spécifié.
Sauf échec de l’opération, la réponse inclut les objets ReceivedCredit qui correspondent aux critères indiqués dans la requête.
Tester des ReceivedCredits![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Utilisez POST /v1/test_
pour simuler la réception de fonds sur un compte financier. Pour simuler un virement bancaire depuis un compte externe vers votre compte financier, définissez initiating_
sur les valeurs du compte bancaire externe, et définissez network
sur ach
ou sur us_
.
La requête suivante entraîne la création d’un ReceivedCredit
en mode test à partir d’un compte bancaire externe en utilisant un OutboundPayment
entre deux comptes financiers de la même plateforme.
Sauf échec de l’opération, la réponse renvoie un objet ReceivedCredit
. Voici un exemple de réponse pour un virement bancaire.
{ "financial_account": "{{FINANCIAL_ACCOUNT_ID}}", "network": "ach", "amount": "1234", "currency": "usd", "description": "Test", "source_details": { "type": "aba", "aba": { "country": "US", "routing_number": "12341234", "account_number": "0123456789", "account_holder_name": "Jenny Rosen", } } }
Webhooks relatifs aux ReceivedCredits![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stripe envoie les événements ReceivedCredit
suivants à votre endpoint de webhook :
treasury.
lors de la création de l’événementreceived_ credit. created ReceivedCredit
.treasury.
lorsque l’état de l’événementreceived_ credit. {{new_ status}} ReceivedCredit
change. Il peut prendre les états suivants :treasury.
received_ credit. succeeded treasury.
received_ credit. failed
treasury.
lors de l’annulation de l’événementreceived_ credit. reversed ReceivedCredit
.