# Virements vers des comptes connectés

Gérez les virements et les comptes externes pour les comptes connectés de votre plateforme.

> Cette page s’adresse aux développeurs qui créent des plateformes avec Stripe Connect. Si vous êtes une entreprise ou un particulier qui reçoit des virements via une plateforme, contactez directement cette plateforme pour obtenir de l’aide concernant les paramètres et l’état de vos virements.

Par défaut, tout [paiement](https://docs.stripe.com/connect/charges.md) que vous effectuez au nom d’un compte connecté vient s’ajouter au [solde](https://docs.stripe.com/connect/account-balances.md) de ce dernier et fait l’objet d’un virement quotidien de façon continue. En fonction des paramètres de vos comptes connectés, votre plateforme peut gérer leurs virements comme suit :

- Établir la [fréquence des virements automatiques](https://docs.stripe.com/connect/manage-payout-schedule.md)
- Effectuer des [virements manuels](https://docs.stripe.com/connect/manual-payouts.md)
- Verser des fonds [instantanément](https://docs.stripe.com/connect/instant-payouts.md)
- Lorsque vous utilisez des [paiements indirects](https://docs.stripe.com/connect/destination-charges.md) ou des [paiements et transferts distincts](https://docs.stripe.com/connect/separate-charges-and-transfers.md), conserver des fonds sur le solde de votre plateforme

## 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* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) 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](https://docs.stripe.com/connect/platform-controls-for-stripe-dashboard-accounts.md) 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 établir la fréquence de leurs virements.

## Devises de règlement prises en charge

Choisissez un pays dans la liste déroulante suivante pour connaître les devises que vous pouvez utiliser pour régler des fonds dans ce pays.

> Pour connaître la liste des devises de présentation prises en charge, consultez la documentation sur les [devises](https://docs.stripe.com/currencies.md#presentment-currencies).
[See table on original page](https://docs.stripe.com/connect/payouts-connected-accounts)
Les plateformes peuvent également permettre à leurs comptes connectés de recevoir des fonds et d’effectuer des virements vers des banques dans certaines devises autres que la devise principale, ou d’effectuer des virements vers des comptes bancaires étrangers dans la devise locale. Dans certains cas, Stripe facture des frais. Pour en savoir plus, consultez la page sur le [virement multidevise pour les plateformes et les marketplaces Connect](https://docs.stripe.com/connect/multicurrency-settlement.md).

## État du virement

Le champ `status` de [l’objet Payout](https://docs.stripe.com/api/payouts/object.md) indique où se trouvent les fonds dans le cycle de vie du virement :

- **`pending`** : le virement a été créé et est en attente d’envoi à la banque. Les fonds n’ont pas encore quitté Stripe.
- **`in_transit`** : les fonds ont été envoyés à la banque et sont en cours d’acheminement vers le compte externe.
- **`paid`** : le virement est arrivé sur le compte externe. Pour les virements standard, cela se produit généralement 1 à 2 jours ouvrables après l’envoi.
- **`failed`** : le virement n’a pas pu être effectué. La propriété `failure_code` de l’objet Payout indique la raison. Lorsqu’un virement échoue, le compte externe concerné est désactivé et ne peut plus recevoir de virements tant que la plateforme n’a pas mis à jour les informations du compte externe du compte connecté.
- **`canceled`** : le virement a été annulé avant l’envoi des fonds à la banque.

Pour la plupart des virements, le cycle de vie complet prend plusieurs jours. Les [virements instantanés](https://docs.stripe.com/connect/instant-payouts.md) arrivent généralement sur le compte dans un délai de 30 minutes.

Si le titulaire du compte connecté ne voit pas les fonds attendus, il doit contacter la plateforme avec laquelle il travaille : la plateforme contrôle les paramètres et les calendriers de virement de ses comptes connectés.

### Suivre les virements avec des webhooks

Vous pouvez suivre toute l’activité de virement sur les comptes connectés en créant une [destination d’événement](https://docs.stripe.com/event-destinations.md) et en écoutant les événements suivants :

- `payout.created` : envoyé lorsqu’un virement est créé (état : `pending`).
- `payout.updated` : envoyé lorsque les détails d’un virement changent, par exemple la date d’arrivée estimée.
- `payout.paid` : envoyé lorsque le virement arrive sur le compte externe (état : `paid`).
- `payout.failed` : envoyé lorsqu’un virement échoue (état : `failed`). Stripe envoie également un événement `account.external_account.updated`, car le compte externe en échec est désactivé.

> #### API Accounts v2
> 
> Quelle que soit la version de l’API Accounts que vous utilisez, les virements déclenchent uniquement les événements v1 décrits ici. Ils n’ont pas d’événements v2 équivalents.

## Prochaines étapes

- [Gérer la fréquence des virements](https://docs.stripe.com/connect/manage-payout-schedule.md)
- [Créer des virements manuels](https://docs.stripe.com/connect/manual-payouts.md)
- [Activer les virements instantanés](https://docs.stripe.com/connect/instant-payouts.md)
- [Gérer les comptes externes des comptes connectés](https://docs.stripe.com/connect/payouts-bank-accounts.md)