Comptes financiers de plateforme

Après que vous ayez obtenu un accès via l’API à Stripe Treasury, nous attribuons automatiquement à votre plateforme deux comptes financiers, un pour le mode test et un pour le mode production.

Le compte financier en mode test de votre plateforme vous permet de configurer et de tester votre intégration sans affecter le solde du compte ni le solde de votre compte financier en mode production.

C’est sur le compte financier de la plateforme en mode production que vous stockez vos propres fonds comme fonds de roulement pour votre programme Treasury. Le compte financier de la plateforme en mode production dispose de ses propres numéros de routage et de compte, et prend en charge la plupart des types de mouvements de fonds proposés par les comptes financiers associés aux comptes connectés de votre plateforme.

Spécificités liées aux comptes financiers

Les comptes financiers (en mode production et en mode test) de votre plateforme sont similaires aux comptes financiers associés aux comptes connectés de votre plateforme. Vous devez utiliser les mêmes requêtes à l’API quel que soit le compte financier concerné. Cependant, vous n’avez pas besoin d’inclure l’en-tête Stripe-Account lorsque vous effectuez des appels à l’API sur le compte financier de votre plateforme. L’en-tête Stripe-Account indique qu’une requête est effectuée pour le compte financier du compte connecté associé plutôt que pour celui de votre plateforme.

La liste suivante détaille les différences entre les comptes financiers de la plateforme et les comptes financiers associés aux comptes connectés :

• Vous ne pouvez pas associer des cartes Stripe Issuing aux comptes financiers de votre plateforme.
  • Vous pouvez associer des cartes Stripe Issuing aux comptes financiers eux-mêmes rattachés à des comptes connectés.
• Vous ne pouvez pas transférer des fonds du solde du compte financier de votre plateforme directement vers le solde d’un compte connecté.
  • Vous pouvez transférer des fonds du solde du compte financier de votre plateforme directement vers le solde d’un compte financier associé à un compte connecté.

• Vous ne pouvez pas utiliser l’API Stripe pour clôturer un compte financier de la plateforme.
  • Private preview Vous pouvez utiliser POST /v1/treasury/financial_accounts/{{FINANCIAL_ACCOUNT_ID}}/close pour clôturer des comptes financiers associés à des comptes connectés si vous avez accès aux méthodes de la version bêta de l’API Closure. Les méthodes de l’API Closure ne vous donnent pas la possibilité de clôturer le compte financier de la plateforme.

• Vous devez utiliser le Dashboard Stripe (plutôt que l’API) pour définir le compte financier de la plateforme en tant qu’objet BankAccount, que vous pouvez utiliser pour les virements effectués depuis le solde des paiements de la plateforme ou les recharges vers ce solde.
  • Pour plus d’informations, consultez le guide sur les virements et les recharges.
• Vous ne pouvez pas accélérer les virements du solde du compte de la plateforme vers le solde du compte financier de la plateforme.

Récupération des informations relatives au compte financier de votre plateforme

Le numéro de routage, le numéro de compte et le solde du compte financier de votre plateforme sont disponibles sous la section Solde Treasury de l’onglet Soldes de votre Dashboard Stripe. Utilisez l’API pour consulter des informations supplémentaires sur le compte financier de votre plateforme.

Solde Treasury

Utilisez GET /v1/treasury/financial_accounts pour renseigner toutes les informations relatives aux comptes financiers de votre plateforme via l’API. Étant donné que cette requête concerne le compte financier de la plateforme, elle ne contient pas l’en-tête Stripe-Account.

curl https://api.stripe.com/v1/treasury/financial_accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

Sauf échec de l’opération, la réponse inclut l’id du compte financier de votre plateforme. Vous pouvez l’utiliser pour récupérer directement les informations relatives au compte financier de votre plateforme à l’aide de la commande GET /v1/treasury/financial_accounts/{{FINANCIALACCOUNT_ID}}.

curl https://api.stripe.com/v1/treasury/financial_accounts/
{{FINANCIAL_ACCOUNT_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

L’objet FinancialAccount affiche les données qui définissent votre compte financier, notamment votre solde et le solde des transactions en attente.

{
  "object": "treasury.financial_account",
  "created": 1612927106,
  "id": "fa_123",
  "country": "US",
  "supported_currencies": ["usd"],
  // Arrays of active, pending and restricted features summarize the status of all requested features
  "active_features": ["financial_addresses.aba", "deposit_insurance"],
  "pending_features": ["inbound_transfers.ach"],
  "restricted_features": ["intra_stripe_flows", "outbound_payments.ach", "outbound_payments.us_domestic_wire"],

Récupération des fonctionnalités pour le compte financier de votre plateforme

Utilisez GET /v1/treasury/financial_accounts/{{FINANCIALACCOUNT_ID}}/features pour récupérer les informations relatives aux fonctionnalités de compte financier de votre plateforme.

curl https://api.stripe.com/v1/treasury/financial_accounts/
{{FINANCIAL_ACCOUNT_ID}}
/features \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

Sauf échec de l’opération, la réponse détaille les fonctionnalités affectées au compte financier de votre plateforme.

{
  "object": "treasury.financial_account_features",
  "card_issuing": {
    "requested": true,
    "status": "active",
    "status_details": []
  },
  "deposit_insurance": {
    "requested": true,
    "status": "active",

Transférer des fonds entre les comptes financiers Treasury de la plateforme et ses comptes connectés

Utilisez OutboundPayments sur le réseau stripe pour déplacer instantanément des fonds entre le compte financier Treasury d’une plateforme et les comptes financiers Treasury des comptes connectés associés à la même plateforme. Consultez Création d’un OutboundPayment à destination d’un compte financier pour en savoir plus.