Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous

Paiements sur les comptes Connectés

Gérez les virements sur les comptes connectés de votre marketplace.

Par défaut, tout paiement que vous effectuez au nom d’un compte connecté s’accumule dans le solde du compte connecté et est payé sur une base quotidienne. Selon la configuration de vos comptes connectés, vous pouvez gérer leurs payouts comme suit :

Vous pouvez utiliser soit votre Dashboard, soit l’API Balance Settings.

Délai de virement

Par défaut, les fonds que vous transférez à un compte connecté s’accumulent dans le solde Stripe du compte connecté et sont versés chaque jour. Vous pouvez configurer la fréquence de virement de votre compte connecté avec soit votre Dashboard, soit l’API.

Utiliser l’API Balance Settings

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/balance_settings \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "payments[payouts][schedule][interval]"=weekly \
  -d "payments[payouts][schedule][weekly_payout_days][]"=monday \
  -d "payments[payouts][schedule][weekly_payout_days][]"=wednesday

Offrez des virements accélérés

Les marketplaces paient souvent les marchands plus fréquemment. Vous pouvez permettre à vos comptes connectés d’accéder immédiatement à leurs soldes après un débit réussi en proposant Instant Payouts. Les virements instantanés sont disponibles à tout moment, y compris les week-ends et jours fériés, et les fonds sont généralement envoyés sur le compte bancaire associé en moins de 30 minutes. Vous pouvez générer des revenus supplémentaires en ajoutant des frais pour de commission pour l’utilisation d’Instant Payouts.

Configurations de gestion des virements

Pour les comptes connectés ayant accès au Dashboard Stripe complet ou au Dashboard Express, le titulaire du compte gère ses comptes de virement externes (comptes bancaires et cartes de débit), mais la plateforme peut établir la fréquence des virements. Pour programmer des virements pour un compte qui a accès au Dashboard Stripe complet, la plateforme doit configurer les contrôles de la plateforme pour le compte.

Pour les comptes connectés qui n’ont pas accès à un Dashboard hébergé par Stripe, la plateforme gère leurs comptes de virement externes et peut planifier leurs virements.

API Accounts v2

L’API Accounts v2 ne prend pas directement en charge le hash external_accounts. Lorsque vous utilisez la v2, utilisez les endpoints /v1/accounts pour gérer external_accounts.

Devises de règlement prises en charge

Sélectionnez un pays dans le menu déroulant suivant pour connaître les devises dans lesquelles vous devez verser des fonds lorsque le compte bancaire externe de votre compte connecté se trouve dans ce pays.

Remarque

Pour connaître la liste des devises de présentation prises en charge, consultez la documentation sur les devises.

Chargement d'un tableau des devises de virement Connect

Vous pouvez également permettre à vos comptes connectés de régler des fonds et de procéder à des paiements vers des banques dans certaines devises non principales, ou de payer des comptes bancaires étrangers dans la devise locale. Dans certains cas, Stripe facture des frais. Pour plus d’informations, consultez la section règlement multidevise pour les marketplaces et plateformes Connect.

Suivre les paiements avec des webhooks

Vous pouvez suivre toutes les activités de virement sur les comptes connectés à l’aide de webhooks en créant une destination d’événement et en écoutant les événements suivants :

  • payout.created
  • payout.updated
  • payout.paid
  • payout.failed

API Accounts v2

Les Payouts ne déclenchent pas d’événements v2. Ils ne déclenchent que les événements v1 décrits ici.

Pour la plupart des virements, les notifications d’événement se produisent sur plusieurs jours. Les virements instantanés envoient généralement l’événement payout.paid dans les 30 minutes qui suivent.

Lorsqu’un virement n’aboutit pas, un événement payout.failed se produit. La propriété failure_code de l’événement en indique la raison. Un virement échoué désactive également le compte externe impliqué dans ce virement, déclenchant un événement account.external_account.updated. Aucun virement ne peut être effectué sur ce compte externe tant que la plateforme n’a pas mis à jour les comptes externes du compte connecté.

Étapes suivantes

Ensuite, apprenez à gérer les remboursements et les litiges.