Virements et recharges depuis Stripe Payments

Comment transférer des fonds entre les soldes de comptes Payments et les soldes de comptes financiers Treasury.

Vous pouvez transférer des fonds de Stripe Payments vers Stripe Treasury par virement, et de Stripe Treasury vers Stripe Payments à l’aide de 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 numéros routing_number et account_number du compte financier pour créer un objet BankAccount 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. S’il y en a un, vous pouvez faire de ce compte financier le nouveau compte connecté par défaut en définissant default_for_currency sur true, 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.

Command Line
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts \
  -usk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -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"

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,
  ...
}

Comptes financiers Fifth Third en tant que comptes externes

Version bêta privée

L’accès à Fifth Third est actuellement limité aux utilisateurs de la version bêta. N’hésitez pas à nous contacter si vous souhaitez l’essayer.

Vous avez maintenant la possibilité de configurer un compte externe en précisant le champ id du compte financier. Vous devez également demander la fonctionnalité intra_stripe_flows sur votre compte financier.

Command Line
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts \
  -usk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "external_account[object]"="bank_account" \
  -d "external_account[financial_account]"="{{FINANCIAL_ACCOUNT_ID}}" \
  -d "external_account[country]"="US" \
  -d "external_account[currency]"="usd" \
  -d "default_for_currency"="true"

Virements

Chaque compte de la plateforme Stripe et chaque compte connecté dispose d’un solde de compte (également appelé solde des paiements ou solde Stripe) qui stocke son argent. Ces fonds ne sont pas directement accessibles pour les utiliser dehors de Stripe. Les virements permettent de déplacer des fonds d’un solde de compte vers un solde de compte financier Treasury accessible de l’extérieur ou vers un compte bancaire externe.

Vous pouvez alimenter un compte financier Treasury à l’aide de virements automatiques ou manuels. Pour en savoir plus sur les comptes Treasury, consultez le guide sur la structure des comptes Stripe Treasury.

Pour en savoir plus sur le fonctionnement des virements avec Connect, consultez le guide sur les virements de fonds.

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 leurs comptes bancaires externes 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 d’un environnement de test.

Dans les environnements de test, vous pouvez uniquement simuler des virements vers le compte financier d’une plateforme en utilisant le Dashboard. 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 d’un compte financier Treasury pour recharger le solde du compte de votre plateforme plutôt qu’un compte bancaire externe. La fonctionnalité financial_addresses.aba de votre compte financier doit être active pour être éligible. 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, de la manière indiquée dans le guide relatif à l’ajout de fonds au solde du compte de votre plateforme.

Contrairement aux véritables comptes bancaires externes, les nouveaux objets BankAccount ayant des informations de compte financier Treasury appartenant au marchand avec l’objet BankAccount 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",
  ...
}

En savoir plus sur l’ajout de fonds au solde du compte de votre plateforme avec Stripe Connect.