Comprendre les soldes de compte Connect

Votre compte de plateforme et le compte connecté sont tous deux des comptes Stripe, chacun avec son propre solde de compte distinct.

Le solde de tous les comptes Stripe peut afficher deux états :

• pending, ce qui indique que les fonds ne sont pas encore disponibles pour le virement
• available, ce qui indique que les fonds peuvent être versés dès maintenant

Hors comptes Connect, les frais de traitement viennent augmenter le solde du compte Stripe. Le montant débité, frais Stripe déduits, est tout d’abord affiché dans le solde en attente, avant de devenir disponible sous 2 jours glissants (délai variable selon les pays et les comptes). Les fonds disponibles peuvent être versés vers un compte bancaire ou une carte de débit. Les virements sont déduits du solde du compte Stripe.

Avec Connect, votre compte de plateforme et chaque compte connecté ont chacun leurs propres soldes pending et available. La répartition des fonds entre eux dépend du type de paiement que vous utilisez.

D’autre part, un compte de plateforme peut également contenir un solde connect_reserved, une réserve permettant de couvrir tout solde négatif éventuel sur vos comptes connectés.

Consulter le solde d’un compte connecté

Pour vérifier le solde d’un compte connecté, exécutez un appel à l’API de récupération de solde authentifié comme le compte connecté. L’objet Balance renvoyé reflète les soldes pending et available.

curl https://api.stripe.com/v1/balance \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

Comptabilisation des soldes négatifs

Certaines actions, telles que les remboursements et les contestations de paiement, génèrent des transactions négatives sur les comptes Stripe. Stripe gère les transactions négatives de manière à maintenir un solde Stripe positif sur les comptes connexes :

• Dans la mesure du possible, Stripe compense automatiquement les transactions négatives avec les paiements futurs
• Stripe attribue d’abord les transactions négatives au compte associé au paiement effectué. Par exemple, pour le paiement sur un compte connecté, un remboursement ou une contestation de paiement provient du compte connecté. Pour un paiement sur votre plateforme, un remboursement ou une contestation de paiement provient de votre compte de plateforme.

Malgré ces mesures, si le solde d’un compte connecté devient négatif, la responsabilité ultime dépend de la propriété controller.losses.payments du compte :

• stripe (y compris les comptes Standard) : le compte connecté est responsable de la couverture de ses propres soldes Stripe négatifs.
• application (y compris les comptes Express et Custom) : la plateforme est responsable de la couverture des soldes Stripe négatifs du compte connecté.

Si le solde d’un compte connecté est négatif, Stripe débite le compte externe enregistré jusqu’à concurrence du nombre maximum de tentatives autorisé. Si toutes les tentatives échouent, Stripe suspend les virements et les débits du compte externe jusqu’à ce que le compte externe enregistré soit mis à jour.

Tant que le solde d’un compte est négatif, vous ne pouvez pas effectuer de virements vers le compte bancaire ou la carte de débit du compte. Les virements vers le compte connecté reprennent lorsque le solde Stripe du compte est à nouveau positif.

Débiter automatiquement les comptes connectés

Si Stripe n’a pas encore tenté de débiter le compte externe d’un compte connecté en raison d’un solde négatif, vous pouvez définir debit_negative_balances sur true afin d’autoriser Stripe à le faire automatiquement.

Le prélèvement automatique en cas de solde négatif est pris en charge pour les banques des pays suivants :

• Australie
• Canada
• Europe (pays de la zone SEPA, y compris le Royaume-Uni)
• Nouvelle-Zélande
• États-Unis

Pour une description détaillée des pays et des types de comptes pris en charge, consultez la FAQ sur les prélèvements automatiques.

L’activation de debit_negative_balances déclenche des prélèvements si nécessaire, même lorsque les virements manuels sont activés sur le compte connecté. Pour en savoir plus, consultez la page Impact des contestations de paiement et soldes négatifs.

Comprendre les soldes de réserve connectée

Pour se protéger contre les soldes available négatifs des comptes connectés dont votre plateforme est responsable, Stripe retient une réserve sur le solde available du compte de plateforme. En fonction du pays du compte connecté, Stripe effectue un retrait sur le compte bancaire du compte pour couvrir le solde négatif. Bien que le solde available du compte soit remis à zéro dès que le retrait est enregistré, la réserve de la plateforme pour ce compte est maintenue pendant 3 jours ouvrables supplémentaires. Vous verrez cette réserve apparaître dans le Dashboard et dans les rapports exportés (comme transaction de réserve).

Il existe trois types d’activité sur solde liés aux réserves :

• Fonds réservés pour couvrir un solde négatif sur un compte connecté. Lorsque le solde d’un compte connecté devient négatif, Stripe réserve temporairement une partie de votre solde pour s’assurer que les fonds peuvent être couverts en créant une transaction de solde avec le type reserve_transaction.
• Fonds débloqués après un changement de solde positif sur un compte connecté. Lorsque le solde précédemment négatif d’un compte connecté devient moins négatif en raison de l’activité sur ce compte (par exemple, par de nouveaux paiements), une partie correspondante du solde de réserve de votre plateforme est débloquée par une opération sur solde de type reserve_transaction.
• Fonds collectés en raison d’un solde négatif de longue date sur un compte connecté. Lorsqu’un compte connecté présente un solde négatif pendant 180 jours, Stripe transfère une partie de votre solde pour annuler celui de ce compte en créant une transaction de solde de type connect_collection_transfer.

Pour consulter les réserves actuelles détenues sur votre compte, effectuez un appel à l’API de récupération de solde pour votre propre compte (c’est-à-dire non autorisé comme autre utilisateur comme dans l’exemple ci-dessus).

Pour couvrir le solde négatif d’un compte connecté et supprimer la réserve sur votre compte, effectuez un transfert vers le compte concerné. Si un compte connecté présente un solde négatif pendant plus de 180 jours, Stripe transfère automatiquement vos réserves sur le compte connecté pour ramener son solde à zéro. Les pages du Dashboard et les rapports affichent ces transferts en tant que transferts de catégorie Connect.

Réserve de fonds

Si vous avez besoin d’un contrôle plus précis sur la planification des virements vers les comptes connectés pour lesquels votre plateforme est responsable des soldes négatifs, vous pouvez adopter l’une des approches suivantes :

• Conserver des fonds dans le solde de la plateforme avant de les transférer dans le solde d’un compte connecté
• Conserver des fonds dans le solde d’un compte connecté avant de les verser sur un compte externe

Nous recommandons de bloquer les fonds sur la plateforme uniquement si vous le faites dans un but précis et avec la certitude que le paiement va être effectué lorsqu’un événement se produit ou qu’une condition préalable est remplie. La réserve de fonds est notamment utilisée par les plateformes de services à la demande : le client attend généralement que le service soit achevé avant de rétribuer le fournisseur de services (par exemple, les locations, les services de livraison et le covoiturage).

Les plateformes doivent s’abstenir de réserver les fonds de manière arbitraire, et au contraire de verser les fonds sur leurs comptes connectés dès qu’ils sont identifiés. C’est généralement le cas lorsque le paiement est effectué. Si vous avez des incertitudes concernant la réserve de fonds, consultez votre conseiller juridique.

Pour des raisons de conformité, nous pouvons retenir les fonds pendant un délai établi selon le pays du marchand :