Virements et recharges depuis Stripe Payments
Vous pouvez déplacer des fonds de Stripe Payments vers Stripe Treasury par virement, et de Stripe Treasury vers Stripe Payments avec des recharges.
Comptes financiers en tant que comptes externes
Vous devez définir votre compte financier en tant que compte externe (l’objet BankAccount
) connecté au compte Stripe approprié avant de pouvoir envoyer ou recevoir des fonds vers ou depuis un compte financier Treasury.
- Comptes connectés : utilisez
POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts
avec les informationsrouting_number
etaccount_number
du compte financier pour créer un objetBankAccount
utilisable pour les virements effectués à partir de comptes connectés. - Comptes de plateforme : utilisez le Dashboard Stripe pour créer un objet
BankAccount
que vous pouvez utiliser pour les virements provenant de votre compte de plateforme ou pour les recharges qui lui sont destinées.
Si aucun compte externe n’est défini par défaut pour la devise usd
, le compte financier devient la destination des virements par défaut du compte. Dans le cas contraire, si vous souhaitez que le compte financier soit le nouveau compte connecté par défaut, définissez default_for_currency
sur true
dans votre appel (comme dans l’exemple suivant). Si vous avez une fréquence de virements automatiques activée, les virements seront redirigés vers le compte financier.
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts \ -u
: \ -d "external_account[object]"="bank_account" \ -d "external_account[routing_number]"="{{FINANCIAL_ACCOUNT_ROUTING_NUMBER}}" \ -d "external_account[account_number]"="{{FINANCIAL_ACCOUNT_ACCOUNT_NUMBER}}" \ -d "external_account[country]"="US" \ -d "external_account[currency]"="usd" \ -d "default_for_currency"="true"sk_test_4eC39HqLyjWDarjtT1zdp7dc
Sauf échec de l’opération, la réponse renvoie le nouvel objet BankAccount
.
{ "id": "{{BANK_ACCOUNT_ID}}", "object": "bank_account", "account": "{{CONNECTED_ACCOUNT_ID}}", "account_holder_name": null, "account_holder_type": null, "available_payout_methods": [ "standard", "instant" ], ... "default_for_currency": true, ... }
Virements
Les virements désignent un transfert de fonds depuis le solde d’un compte (également appelé solde des paiements ou solde Stripe) vers le solde d’un compte financier Treasury ou vers un compte bancaire externe. Chaque compte de plateforme Stripe, ainsi que chaque compte connecté de cette même plateforme, possède un solde sur lequel sont conservés les fonds gagnés par le propriétaire du compte (consultez le guide sur la structure des comptes Stripe Treasury pour en savoir plus sur les types de comptes Treasury). Ces fonds ne peuvent pas être directement utilisés en dehors de Stripe tant que les utilisateurs n’ont pas transféré l’argent sur le compte approprié. Avec Stripe Treasury, il s’agit du compte financier, que vous pouvez alimenter en effectuant des virements automatiques ou des virements manuels. Pour en savoir plus sur les virements avec Stripe Connect, consultez le guide consacré aux virements.
Virements automatiques
Si certains des comptes connectés de votre plateforme sont dotés d’une fréquence de virements automatiques, vous pouvez modifier le bénéficiaire des virements directs en remplaçant les comptes bancaires externes des utilisateurs des comptes connectés par leurs comptes financiers. Pour cela, le compte financier Treasury doit être défini comme un objet BankAccount
. Pour en savoir plus, consultez la section Comptes financiers en tant que comptes externes.
Délai des virements automatiques
Par défaut, lorsque vous utilisez les virements automatiques, les fonds provenant de paiements par carte sont disponibles sur le solde du compte financier deux jours ouvrés après la réception du paiement (délai T+2). Les autres types de paiements, tels que les paiements ACH peuvent mettre plus longtemps à apparaître.
Après l’approbation de crédit au niveau de la plateforme, vous pouvez activer les virements accélérés T+1 au niveau de chaque compte connecté. Vous pouvez définir les paramètres interval
et delay_days
avec POST /v1/accounts
pour augmenter automatiquement la fréquence des paiements. Vous pouvez également activer manuellement les virements accélérés comme décrit ci-dessous. Contactez nos équipes à l’adresse treasury-support@stripe.com si vous souhaitez demander un accès aux virements accélérés (manuels, automatisés, ou les deux) pour les comptes connectés sur votre plateforme.
Les virements accélérés T+1 s’appliquent à tous les types de paiements, dont les paiements par carte et les paiements ACH.
Fréquence des virements automatiques à T+1
Pour recevoir automatiquement des paiements sur le compte financier dans un délai d’un jour ouvrable, envoyez une requête en définissant interval
sur daily
et delay_days
sur 1
.
Utilisez POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}
pour mettre à jour la fréquence des virements.
La réponse confirme la mise à jour des paramètres.
{ ... "settings": { "payouts": { "schedule": { "interval": "daily", "delay_days": 1, }, }, ... } ... }
Virements manuels
Vous pouvez utiliser les virements manuels afin d’envoyer des sommes spécifiques depuis le solde d’un compte vers le compte financier Treasury de ce même compte.
Utilisez POST /v1/payouts
avec l’id
du compte bancaire associé à votre compte financier défini en tant que valeur du paramètre destination
. Si vous n’avez pas encore d’objet BankAccount
associé à votre compte financier Treasury, consultez la section relative aux comptes financiers en tant que comptes externes pour en savoir plus.
Sauf échec de l’opération, la réponse renvoie le nouvel objet Payout
.
{ "id": "{{PAYOUT_ID}}", "object": "payout", "amount": 1000, ... "currency": "usd", "destination": "{{BANK_ACCOUNT_ID}}", ... "method": "standard", ... }
Délai des paiements manuels
Il existe deux vitesses pour les paiements manuels : standard
et instant
.
Les fonds des virements manuels utilisant la vitesse standard
peuvent uniquement provenir du solde available
. En général, les fonds arrivent sur le compte financier dans un délai d’un jour ouvré (T+1).
Si les virements accélérés ont été activés pour votre plateforme, vous pouvez utiliser les paiements manuels instant
pour transférer des fonds vers le compte financier d’un compte connecté en moins d’une heure. Vous pouvez demander des paiements manuels instantanés à tout moment, y compris les week-ends et les jours fériés. Les fonds peuvent être prélevés sur le solde instant_available
d’un compte Stripe. Si les paiements accélérés ne sont pas activés sur votre plateforme et que vous souhaitez les activer, contactez nos équipes à l’adresse treasury-support@stripe.com pour demander cette fonctionnalité.
Si vous souhaitez demander un virement manuel instantané plutôt qu’un virement manuel standard, définissez le paramètre method
sur instant
au lieu de standard
dans la requête de virement.
Test des virements
Vous pouvez simuler un virement vers le compte financier d’un compte connecté en utilisant des clés API en mode test.
Vous pouvez uniquement simuler des virements vers le compte financier d’une plateforme en utilisant le Dashboard. En mode test, cliquez sur le bouton Ajouter des fonds en haut à droite de la vue Soldes de votre Dashboard afin d’ouvrir la boite de dialogue Ajouter des fonds. Suivez les instructions pour simuler un envoi de fonds du solde de votre compte de plateforme au solde de votre compte financier.
Bouton Ajouter des fonds
Recharges
En tant que propriétaire d’une plateforme Connect, vous pouvez utiliser le solde de votre compte financier Treasury pour recharger le solde du compte de votre plateforme plutôt qu’un compte bancaire externe. Pour recharger le solde du compte d’une plateforme, vous devez configurer le compte financier Treasury de la plateforme en tant que BankAccount
externe par défaut de cette plateforme à l’aide du Dashboard de Stripe tel que présenté dans le guide relatif à l’ajout de fonds au solde de votre plateforme.
Contrairement aux véritables comptes bancaires externes, les nouveaux objets BankAccount
ayant des informations de compte financier Treasury sont vérifiés automatiquement à leur création, ainsi la vérification à l’aide de microversements n’est pas nécessaire.
Après avoir défini le compte financier Treasury comme compte bancaire externe par défaut de votre plateforme, utilisez POST /v1/topups
pour créer la recharge.
Sauf échec de l’opération, la réponse renvoie l’objet Top-Up
.
{ "id": "{{TOP_UP_ID}}", "object": "topup", "amount": 2000, "currency": "usd", "description": "Top-up", ... }
Découvrez comment ajouter des fonds au solde du compte de votre plateforme avec Stripe Connect.