Fonctionnement des comptes connectés dans Treasury

Pour utiliser Stripe Treasury, votre plateforme doit posséder une intégration Stripe Connect. Stripe Connect permet aux plateformes de mettre des comptes connectés à la disposition de leurs marchands et fournisseurs de services. Consultez le guide sur la structure des comptes Stripe Treasury pour avoir un aperçu du fonctionnement des comptes connectés avec la structure d’un compte Stripe Treasury.

Treasury prend uniquement en charge les comptes connectés qui n’utilisent pas de Dashboard hébergé par Stripe, et dont votre plateforme est responsable de la collecte des exigences et des pertes, y compris les comptes connectés Custom. Découvrez comment créer des comptes connectés qui fonctionnent avec Treasury.

En tant que plateforme disposant de comptes connectés, vous êtes tenu(e) de maintenir une version compatible de l’API, de communiquer à vos comptes connectés les mises à jour des conditions d’utilisation de votre service, de traiter leurs demandes d’information et de leur fournir une assistance. Étant donné que votre plateforme est responsable en dernier ressort des pertes subies par vos comptes connectés, vous devez contrôler vos comptes connectés pour prévenir la fraude. Pour en savoir plus, consultez le guide Treasury sur la fraude.

Pour profiter pleinement de Stripe Treasury, vous devez activer certaines fonctionnalités spécifiques sur vos comptes connectés. Vous pouvez être amené à fournir des informations supplémentaires sur les propriétaires de vos comptes connectés. La fonctionnalité treasury, par exemple, est une exigence applicable aux comptes connectés pour avoir accès à Treasury. Lorsque vous demandez la fonctionnalité treasury pour un compte, vous devez renseigner des champs supplémentaires avant que le compte puisse utiliser Treasury.

Avant de créer des comptes connectés en mode production pour votre intégration Treasury, nous vous recommandons de créer d’abord des comptes connectés de test dans un environnement de test. Les comptes connectés de test ne peuvent pas recevoir ni envoyer de fonds réels et ne peuvent pas être utilisés en mode production, mais leur configuration et leurs fonctionnalités sont par ailleurs identiques.

Vérifier le type de vos comptes connectés existants

Si votre plateforme dispose déjà d’une intégration Connect avec des comptes connectés mais que vous avez un doute sur leur type, vous pouvez utiliser le Dashboard ou l’API pour récupérer ces informations.

Dashboard

Requête API

Accédez à la page Comptes connectés du Dashboard. Vos comptes connectés sont listés sous forme de tableau.

Comptes Connectés

Pour trouver les fonctionnalités d’un compte, sélectionnez-le dans le tableau pour ouvrir la vue détaillée, puis cliquez sur Profil > Informations du compte.

Informations du compte

Créer un nouveau compte connecté avec la fonctionnalité Treasury

Utilisez POST /v1/accounts pour créer un nouveau compte connecté. Demandez les fonctionnalités suivantes pour le compte, nécessaires pour l’utilisation de Stripe Treasury :

• transfers (requis pour tous les comptes connectés)
• treasury

Si vous souhaitez émettre des cartes pour votre compte connecté via Stripe Issuing, vous devez également demander la fonctionnalité card_issuing. Consultez notre guide relatif à l’utilisation des cartes Issuing de Stripe pour obtenir plus d’informations.

Si vous souhaitez transférer des fonds via le réseau ACH vers ou depuis un compte externe, vous devez également demander la fonctionnalité us_bank_account_ach_payments.

Voici un exemple de requête regroupant toutes les options citées précédemment :

const account = await stripe.accounts.create({
  country: 'US',
  email: email,
  capabilities: {
    transfers: {requested: true},
    treasury: {requested: true},
    card_issuing: {requested: true},
  },
  controller: {
    dashboard: {type: "none"},
    losses: {payments: "application"},
    requirement_collection: "application",
    fees: {payer: "application"}
  },
});

Sauf échec de l’opération, la réponse confirme la création du compte connecté et l’activation de la fonctionnalité capabilities demandée.

{
  "id": "acct_1234",
  "object": "account",
  "capabilities": {
    "card_issuing": "inactive", // Should be requested only for Stripe Issuing users.
    "treasury": "inactive",
    "us_bank_account_ach_payments": "inactive"
  },
  ...
}

Pour en savoir plus sur les fonctionnalités des comptes connectés, consultez le guide Fonctionnalités du compte pour Connect.

Mettre à jour un compte connecté pour intégrer la fonctionnalité Treasury

Si l’un de vos comptes connectés dispose déjà de la fonctionnalité card_payments activée, utilisez POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} pour mettre à jour le compte avec l’ID associé en demandant la fonctionnalité treasury. La requête suivante demande la fonctionnalité treasury pour un compte connecté et inclut les fonctionnalités facultatives card_issuing et us_bank_account_ach_payments :

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "capabilities[treasury][requested]"=true \
  -d "capabilities[card_issuing][requested]"=true \
  -d "capabilities[us_bank_account_ach_payments][requested]"=true

Vous pouvez utiliser POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} afin de mettre à jour les fonctionnalités des comptes connectés pour lesquels vous avez déjà spécifié un FinancialAccount. Pour en savoir plus, consultez la page Fonctionnement des comptes financiers ou la section de la documentation de l’API consacrée à l’objet FinancialAccount.

Inscrire le compte connecté

Après avoir créé un compte, vous devez procéder à l’inscription du marchand ou fournisseur de service qui en sera propriétaire. L’objet Account, qui représente le compte connecté, possède un hachage requirements ; celui-ci contient les exigences de vérification d’identité currently_due. Le marchand ou le fournisseur de services de votre plateforme doit renseigner les informations détaillées requises dans le hachage requirements afin d’activer les paiements et les virements sur son compte connecté, ainsi que toutes les fonctionnalités demandées pour son compte financier.

Deux options s’offrent à vous pour inscrire des titulaires de comptes connectés à Treasury : l’inscription hébergée et l’inscription personnalisée. Nous vous recommandons l’inscription hébergée.

Si vous créez un objet Account de test et que vous souhaitez contourner les exigences d’inscription des utilisateurs pour tester la fonctionnalité, utilisez POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} pour fournir des valeurs de test qui répondent à toutes les exigences. La requête suivante utilise un compte connecté créé précédemment afin de fournir les informations requises sur le compte.

curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "tos_acceptance[date]"=1547923073 \
  -d "tos_acceptance[ip]"="172.18.80.19" \
  -d "settings[treasury][tos_acceptance][date]"=1547923073 \
  -d "settings[treasury][tos_acceptance][ip]"="172.18.80.19" \
  -d "business_profile[mcc]"=5045 \
  --data-urlencode "business_profile[url]"="https://bestcookieco.com" \
  -d "company[address][city]"=Schenectady \
  -d "company[address][line1]"="123 State St" \
  -d "company[address][postal_code]"=12345 \
  -d "company[address][state]"=NY \
  -d "company[tax_id]"=000000000 \
  -d "company[name]"="The Best Cookie Co" \
  -d "company[phone]"=8888675309 \
  -d "individual[first_name]"=Jenny \
  -d "individual[last_name]"=Rosen

Utilisation de l’inscription hébergée

Utilisez Connect Onboarding pour collecter efficacement les informations requises. Ainsi, Stripe traite les aspects complexes de la vérification et collecte l’acceptation des conditions d’utilisation du service. Vous pouvez également rédiger vos propres requêtes à l’API pour l’intégration initiale, en prenant soin de surveiller l’évolution des exigences de conformité pour maintenir votre flux d’inscription des utilisateurs à jour. Découvrez comment créer des comptes connectés qui fonctionnent avec Treasury.

Avant de pouvoir utiliser Connect Onboarding, vous devez définir le nom, la couleur et l’icône de votre marque dans la section Marque de la page de paramètres Connect. Vous pourrez ainsi personnaliser l’apparence du formulaire d’inscription à votre plateforme présenté aux marchands et fournisseurs de services.

Pour tirer parti de Connect Onboarding, utilisez POST /v1/account_links pour créer un attribut AccountLink à fournir au marchand ou au fournisseur de services qui va devenir propriétaire du compte connecté :

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  --data-urlencode refresh_url="https://example.com/reauth" \
  --data-urlencode return_url="https://example.com/return" \
  -d type=account_onboarding

Le résultat contient l’URL à partager à votre utilisateur.

{
  "object": "account_link",
  "created": 1612927106,
  "expires_at": 1612927406,
  "url": "https://connect.stripe.com/setup/s/iCtLfmYb2tEU"
}

Utiliser l’inscription intégrée

L’inscription intégrée est une interface utilisateur d’inscription personnalisable avec un marquage Stripe limité. Elle vous offre plus de contrôle sur l’expérience utilisateur que la solution d’inscription hébergée de Stripe. Avec l’inscription intégrée des utilisateurs, vous bénéficiez d’un flux d’inscription personnalisé, sans la complexité et les efforts qu’impliquerait la mise à jour de votre intégration d’inscription à chaque évolution des exigences de conformité.

Votre plateforme intègre le composant d’inscription de compte dans votre application, et vos comptes connectés interagissent avec le composant intégré sans quitter votre application. L’inscription intégrée utilise l’API Accounts pour lire les exigences et générer un formulaire d’inscription hébergée avec une validation robuste des données. Elle est localisée pour tous les pays dans lesquels Stripe est disponible.

Utilisation de l’inscription personnalisée

Si vous préférez créer un processus d’inscription personnalisé pour vos utilisateurs, utilisez POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} et POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}/persons/{{PERSON_ID}} pour mettre à jour les objets Account et Person correspondants avec les informations requises.

Vous devez également vous assurer que le propriétaire du compte connecté a lu et accepté le Contrat d’utilisation de Stripe Treasury. Pour en savoir plus sur le respect des conditions d’inscription, consultez la page Traitement des vérifications avec l’API.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "company[name]"=Homebox \
  -d "company[address][line1]"="123 Market St." \
  -d "company[address][city]"="San Francisco" \
  -d "company[address][state]"=CA \
  -d "company[address][postal_code]"=94107 \
  -d "company[address][country]"=US

Conditions requises

Les champs des tableaux suivants sont obligatoires pour les utilisateurs de Treasury.

Finalisation

Le processus d’inscription du compte connecté s’achève lorsque vous recevez un webhook account.updated confirmant les champs suivants sur votre compte connecté :

{
  "object": {
    "object": "account",
    "id": "acct_1234",
    "capabilities": {
      "treasury": "active",
      "card_issuing": "active", // Only appears if requesting the `card_issuing` capability.
      "us_bank_account_ach_payments": "active", // Only appears if requesting the `us_bank_account_ach_payments` capability.
    },
    ...
  }
}

Si le partenaire bancaire de votre plateforme est Evolve Bank & Trust, le délai d’attente pour l’ouverture d’un compte est de moins de cinq minutes.

Mises à jour apportées aux exigences

Afin de s’adapter à l’évolution des réglementations financières, Stripe doit occasionnellement mettre à jour ses exigences en matière de collecte d’informations pour Treasury. Le tableau requirements.eventually_due de l’objet Account capture les nouvelles informations ainsi exigées. En savoir plus sur le hachage requirements.