Débiter des comptes Express et Custom

Votre plateforme peut parfois avoir besoin de collecter des fonds auprès de vos comptes connectés :

• Pour débiter le compte connecté directement 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 Express ou Custom, vous pouvez débiter le solde Stripe d’un compte connecté pour créditer celui du compte de votre plateforme.

Stripe vous permet de réaliser cette opération de deux façons :

• Débiter un compte connecté du montant des produits ou services de votre plateforme
• Réaliser un transfert depuis un compte connecté pour récupérer des fonds ou procéder à d’autres réajustements

Ces deux approches aboutissent au même flux de fonds : un objet Transfer est créé sur le compte connecté et un objet Payment est créé sur le compte de la plateforme.

Conditions requises

Cette fonctionnalité n’est prise en charge que pour les comptes Express et Custom. De plus :

• Le compte connecté et la plateforme doivent se trouver dans la même région (tous deux en Europe ou aux États-Unis, par exemple).
• La valeur currency doit correspondre à la devise par défaut du compte connecté.
• Débiter un compte connecté ne peut pas rendre son solde négatif, sauf si les réserves sont activées (par défaut sur toutes les nouvelles plateformes créées après le 31 janvier 2017) et que vous disposez d’un compte bancaire dans la même devise que la somme débitée.
• Si un compte connecté présente un solde négatif, Stripe peut débiter automatiquement le compte externe enregistré, en fonction du pays dans lequel se trouve le compte connecté.

Pour éviter les échecs, vérifiez la banque du compte connecté avant d’utiliser la fonctionnalité Débits de compte.

Débiter un compte connecté

L’appel à l’API de création de paiement permet de fournir un ID de compte connecté en tant que valeur source :

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -d amount=1500 \
  -d currency=usd \
  -d source=
{{CONNECTED_ACCOUNT_ID}}

L’appel à l’API renvoie l’objet Payment créé sur le compte de la plateforme (remarque : il ne renvoie pas d’objet Charge).

Cette approche est adaptée aux plateformes qui débitent leurs comptes connectés en échange de biens et de services (c’est-à-dire pour l’utilisation de la plateforme). Par exemple, une plateforme peut débiter le montant de frais ou services supplémentaires sur ses comptes connectés par le biais de leur solde Stripe et minimiser ainsi la nécessité de collecter un moyen de paiement supplémentaire, tout en bénéficiant d’une disponibilité quasi instantanée des fonds.

Transfert depuis un compte connecté

La seconde méthode pour débiter un compte connecté consiste à créer un transfert depuis le compte connecté et vers le compte de votre plateforme. Utilisez l’en-tête Stripe-Account pour vous authentifier en tant que compte connecté et fournissez l’ID du compte Stripe de votre plateforme pour la valeur destination :

curl https://api.stripe.com/v1/transfers \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1500 \
  -d currency=usd \
  -d destination={{PLATFORM_STRIPE_ACCOUNT_ID}}

Cet appel à l’API renvoie l’objet Transfer créé sur le compte connecté.

Cette approche permet notamment d’effectuer des réajustements sur une plateforme (corriger une erreur de paiement ou récupérer des frais que vous avez payés à Stripe, par exemple).

Notez que vous avez besoin de l’identifiant de compte Stripe de votre plateforme pour exécuter cette requête. Si vous ne le connaissez pas encore, effectuez un appel à l’API de récupération de compte à l’aide de la clé API de votre plateforme :

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_VePHdqKTYQjKNInc7u56JBrQ
:"

Cet appel à l’API renvoie l’objet Account qui représente le compte de votre plateforme.