Virements et recharges depuis Stripe Payments

Vous pouvez transférer des fonds de Stripe Payments vers Financial Accounts pour les plateformes à l’aide de virements, et de Financial Accounts pour les plateformes vers Stripe Payments à l’aide de recharges.

Comptes financiers en tant que comptes externes

Avant de pouvoir effectuer des virements vers un compte financier ou recevoir des recharges depuis un compte financier, vous devez configurer le compte financier en tant que compte externe (objet BankAccount) connecté au compte Stripe correspondant.

• 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.

curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts \
  -u 
sk_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

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.

curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts \
  -u 
sk_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 sauvegarde de l’argent. Ces fonds ne peuvent pas être utilisés directement en dehors de Stripe. Les virements permettent de transférer des fonds d’un solde de compte vers un compte bancaire externe ou un compte financier accessible de l’extérieur.

Vous pouvez alimenter un compte financier par virements automatiques ou manuels. En savoir plus sur les comptes financiers.

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 des 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 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.

curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "settings[payouts][schedule][interval]"=daily \
  -d "settings[payouts][schedule][delay_days]"=1

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 de ce même compte.

Utilisez la méthode POST /v1/payouts avec un id de compte bancaire associé à votre compte financier spécifié comme valeur du paramètre de destination. Si vous ne disposez pas encore d’un objet BankAccount associé à votre compte financier, pour en savoir plus,consultez la section Comptes financiers en tant que comptes externes.

curl https://api.stripe.com/v1/payouts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d method=standard \
  -d amount=1000 \
  -d currency=usd \
  -d destination={{BANK_ACCOUNT_ID}}

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 virements manuels effectués avec la vitesse standard ne peuvent être prélevés que sur le solde available, et les fonds arriveront généralement dans le compte financier dans les 2 heures.

Si votre plateforme est activée pour des virements accélérés, vous pouvez utiliser les virements manuels instant pour transférer les fonds vers le compte financier d’un compte connecté dans les 30 minutes. Vous pouvez demander des paiements manuels instantanés à tout moment, y compris les week-ends et les jours fériés, et les paiements manuels instantanés peuvent être utilisés dans les soldes instant_available d’un compte Stripe. Si votre plateforme n’est pas compatible avec les virements accélérés et que vous souhaitez ajouter cette fonctionnalité, contactez treasury-support@stripe.com pour demander la 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.

Recharges

En tant que propriétaire d’une plateforme Connect, vous pouvez utiliser un solde de compte financier admissible pour recharger le solde de votre compte de plateforme plutôt que d’utiliser un compte bancaire externe. La fonctionnalité financial_addresses.aba doit être active sur votre compte financier pour être admissible. Pour recharger le solde d’un compte de plateforme, vous devez définir le compte financier de la plateforme comme BankAccount externe par défaut de la plateforme à l’aide du Dashboard Stripe, comme décrit dans le guide Ajouter des fonds au solde de votre plateforme.

Contrairement aux véritables comptes bancaires externes, les nouveaux objets BankAccount ayant des informations de compte financier appartenant au marchand avec l’objet BankAccount sont vérifiés automatiquement à leur création.

Après avoir défini le compte financier comme compte bancaire externe par défaut de votre plateforme, utilisez la méthode POST /v1/topups pour créer la recharge.

curl https://api.stripe.com/v1/topups \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=2000 \
  -d currency=usd \
  -d description=Top-up \
  -d statement_descriptor=Top-up

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.