Débiter des comptes dont le risque est géré par Stripe
Votre plateforme peut parfois avoir besoin de collecter des fonds auprès de vos comptes connectés :
- Pour débiter directement le compte connecté du montant des produits ou services
- Pour récupérer les fonds d’un remboursement antérieur
- Pour procéder à d’autres réajustements sur des soldes de comptes connectés (par exemple, pour corriger une erreur)
Lorsque vous utilisez des comptes dont le risque est géré par Stripe (pour lesquels Stripe est responsable des pertes), vous pouvez débiter le solde Stripe d’un compte connecté pour créditer le compte de votre plateforme. Cela crée un Transfer
sur le compte connecté et un Payment
sur le compte de la plateforme.
Mise en garde
Pour effectuer débiter des comptes, vous devez obtenir un consentement juridiquement opposable de vos comptes connectés. Cette fonctionnalité est disponible en Australie, au Canada, en Europe, à Hong Kong, au Japon, en Nouvelle-Zélande et aux États-Unis. Stripe prend en charge les débits sur les comptes uniquement lorsque votre plateforme et le compte connecté se trouvent dans la même région (par exemple si les deux sont établis au Japon). Si d’autres régions vous intéressent, contactez l’équipe commerciale. L’utilisation des débits de compte entraîne des frais supplémentaires.
Exigences
Les exigences fonctionnelles pour débiter des comptes connectés dont le risque est géré par Stripe sont différentes de celles des comptes Express, Custom ou dont le risque est géré par la plateforme. Pour plus d’informations sur la manière de débiter ces types de comptes, veuillez vous reporter à la page Débiter des comptes Express et Custom.
Pour débiter des comptes dont le risque est géré par Stripe :
- Le compte connecté et la plateforme doivent se trouver dans la même région (tous deux en Europe ou tous deux aux États-Unis, par exemple).
- La valeur
currency
doit correspondre à la devise par défaut du compte connecté. - Si le solde d’un compte connecté devient négatif à la suite d’un débit sur le compte, nous maintiendrons le montant approprié de réserves sur le solde de la plateforme. Pour plus d’informations, consultez la page Comprendre les soldes de réserve liés aux comptes connectés dont le risque est géré par Stripe.
Pour une expérience optimale, vérifiez la banque du compte connecté avant d’utiliser les débits de compte.
Transfert depuis un compte connecté
Pour débiter des comptes connectés dont le risque est géré par Stripe , créez un Transfer
de votre compte connecté vers le compte de votre plateforme et fournissez la reference_transaction
à l’origine du débit. La transaction indiquée doit être de type Charge
, Payment
ou Payout
et avoir été créée sur le compte connecté débité.
Comme toujours, lorsque vous effectuez un transfert par prélèvement d’un compte, utilisez l’en-tête Stripe-Account
pour vous identifier en tant que compte connecté et fournissez l’ID du compte Stripe de votre plateforme comme destination
.
Pour effectuer un débit suite à une transaction antérieure de type Charge
ou Payment
sur le compte connecté :
Pour effectuer un débit suite à une transaction antérieur de type Payout
sur le compte connecté :
En cas de réussite, les deux appels à l’API précédents renvoient le Transfer
créé sur le compte connecté. Dans les deux cas, le Transfer
renvoyé correspond à un Payment
créé sur le compte de votre plateforme.
Vous devez utiliser l’ID du compte Stripe de votre plateforme pour effectuer cette requête. Si vous ne le connaissez pas encore, exécutez un appel de récupération de compte à l’API à l’aide de la clé API de votre plateforme :
Cet appel à l’API renvoie l’objet Account
qui représente le compte de votre plateforme.