Solutions d'inscription pour les comptes Custom

Choisissez la méthode d'inscription des comptes Custom qui convient à votre entreprise.

Stripe propose plusieurs façons d’inscrire des comptes connectés Custom. Vous êtes libre de choisir la méthode d’intégration la plus adaptée à votre entreprise.

Remarque

Nous vous recommandons d’utiliser des composants d’inscription hébergés par Stripe ou des composants intégrés. Les deux sont automatiquement mis à jour pour gérer les nouvelles exigences lorsqu’elles s’appliquent à un compte connecté. Avec les composants intégrés, vous pouvez les adapter à votre image de marque et contrôler les stratégies et les conditions qui seront affichées.

Moyen de paiement	Avantages	Inconvénients
Inscription hébergée par Stripe	Intégration simplifiée	Avec le logo de la marque Stripe et un nombre limité de logos de la plateforme Contrôle limité sur la logique de flux Les comptes connectés sont redirigés vers Stripe au lieu d’effectuer le processus sans quitter votre site
Inscription intégrée	Hautement thématisable Image de marque Stripe limitée ou absente Les comptes connectés restent dans le flux de votre site Intégration simplifiée	Contrôle limité sur la logique de flux
Inscription basée sur l’API	Contrôle total sur votre propre interface utilisateur	Mise en place coûteuse et chronophage Maintenance continue, notamment pour garantir la conformité aux exigences mondiales en constante évolution Impossible de résoudre les vérifications des risques de Stripe

Inscription hébergée par Stripe

L’inscription hébergée par Stripe vous permet de rediriger votre utilisateur vers Stripe pour terminer le processus d’inscription au sein d’une interface comarquée. Créez un lien de compte et renvoyez votre utilisateur vers le flux d’inscription hébergé. Le return_url permet à Stripe de rediriger l’utilisateur vers votre application et de vous permettre de faire avancer le compte connecté en conséquence.

Pour intégrer l’inscription hébergée par Stripe, suivez notre guide sur l’intégration hébergée par Stripe.

Inscription intégrée

L’inscription intégrée est une interface utilisateur d’inscription hautement personnalisable avec un marquage Stripe limité. Les utilisateurs de comptes connectés interagissent avec le composant intégré sans jamais quitter votre application. L’inscription intégrée utilise l’API Accounts pour lire les exigences et générer un formulaire d’inscription doté d’une validation des données efficace et localisé pour tous les pays pris en charge par Stripe. De plus, l’inscription intégrée gère tous les éléments suivants :

Types d’entreprises
Configurations des représentants de l’entreprise
Chargement du document de vérification
Identifier la vérification et les états
Comptes bancaires internationaux
États d’erreur

L’inscription intégrée des utilisateurs s’effectue en quelques lignes de code, tandis que leur inscription via l’API nécessite la création d’une logique personnalisée. Pour l’inscription intégrée, suivez notre guide sur les composants intégrés et intégrez le composant intégré d’inscription des comptes.

Inscription basée sur les API

L’inscription basée sur l’API implique de développer chaque aspect de l’Interface utilisateur d’inscription de votre site pour appeler les API Stripe correspondantes. Votre intégration doit répondre à toutes les exigences d’inscription de Stripe.

Définir des exigences

Les facteurs suivants affectent les exigences d’inscription pour vos comptes connectés :

Pays d’origine des comptes connectés
Le type de contrat de service applicable aux comptes connectés
Fonctionnalités demandées pour les comptes connectés
Le business_type (par exemple, particulier ou entreprise) et la structure de l’entreprise (par exemple, public_corporation ou private_partnership)

Utilisez le formulaire interactif pour voir comment la modification de ces facteurs affecte les exigences.

Formulaire d'exigences

Créer des formulaires pour collecter des informations

Il est recommandé d’organiser les paramètres requis en groupes logiques ou en formulaires dans votre flux d’inscription. Vous pouvez coder un mappage entre les paramètres Stripe et les regroupements logiques. Les regroupements logiques suggérés pour les paramètres sont indiqués dans la première colonne de l’exemple de tableau des exigences.

Après avoir encodé les paramètres requis au sein de votre application, générez des interfaces utilisateur pour les paramètres correspondant à ces exigences. Pour chaque paramètre, créez un formulaire d’interface utilisateur qui comprend :

Libellé de paramètre, localisé dans chaque pays et langue pris en charge
Description des paramètres, localisée dans chaque pays et langue pris en charge
Champs de saisie des paramètres avec logique de validation des données et chargement de documents au besoin

Il est important de structurer votre logique d’application pour prendre en compte la possibilité d’ajouter des paramètres ultérieurement. Par exemple, Stripe peut introduire de nouveaux paramètres, de nouvelles vérifications ou de nouveaux seuils que vous devez intégrer dans vos flux d’inscription au fil du temps.

Si vous modifiez l’un des facteurs qui déterminent les exigences relatives à vos comptes connectés, vous devez également adapter vos formulaires de collecte. Le pays et le type de contrat de service sont immuables, tandis que les fonctionnalités et le type d’activité sont modifiables.

Pour modifier un champ immuable tel que le pays ou le type de contrat de service, créez un nouveau compte connecté avec les nouvelles valeurs. Cela génère de nouvelles exigences que vous devez intégrer à vos flux de collecte.
Pour modifier un champ modifiable, comme les fonctions ou le type d’entité, mettez à jour le compte connecté. Cela génère de nouvelles exigences que vous devez intégrer à vos flux de collecte.

Inclure le consentement aux Conditions d’utilisation du service Stripe

Avant leur activation, vos comptes connectés doivent accepter les Conditions d’utilisation du service de Stripe. Vous pouvez inclure les Conditions d’utilisation du service de Stripe aux vôtres.

Créer un compte connecté

Utilisez l’API Create Account pour créer un compte connecté spécifiant le pays, le contrat de type de service, les fonctionnalités souhaitées, le type d’entreprise et toute autre information correspondant à vos exigences. Les attributs capabilities et type doivent obligatoirement être spécifiés. Si vous les laissez vides, certains autres paramètres reçoivent les valeurs par défaut suivantes :

Le contrat de type de service (tos_acceptance.service_agreement) est défini sur full par défaut.
Le country par défaut est le même pays que celui de votre plateforme.

L’exemple de code suivant crée un compte connecté personnalisé avec des fonctions card_payments et de transfers dans le cadre d’un contrat de service complet pour un particulier.

Remarque

Cet exemple n’inclut qu’une partie des champs qu’il est possible de définir à la création d’un compte. Pour obtenir la liste complète des champs disponibles, tels que address et website_url, consultez la documentation relative à l’API Create Account.

Faire passer votre compte par le flux d’inscription

Vous pouvez activer les comptes connectés de deux manières :

Stratégie d’inscription progressive : seules les informations requises sont collectées dans un premier temps, le reste ultérieurement
Stratégie d’inscription complète : toutes les informations requises sont collectées d’emblée

La stratégie d’inscription progressive permet une inscription initiale plus rapide, mais nécessite de recueillir des informations complémentaires par la suite. La stratégie d’inscription complète limite les suspension de fonctionnalités tout au long du cycle de vie du compte connecté, au détriment d’un processus initial plus long. Vous pouvez choisir la stratégie la plus adaptée à votre cas d’usage.

Pour mettre en œuvre votre stratégie d’inscription, vérifiez le hash requirements du compte connecté que vous avez créé. Le hash requirements fournit une liste complète des paramètres que vous devez recueillir pour activer le compte connecté.

Si vous choisissez la stratégie d’inscription progressive, examinez le champ currently_due dans le hash requirements et créez un flux d’inscription qui collecte uniquement les paramètres répertoriés.
Si vous choisissez la stratégie d’inscription complète, vérifiez le champ eventually_due dans le hash requirements et créez un flux d’inscription des utilisateurs qui collecte tous les paramètres répertoriés.

{
  ...
  "requirements": {
    "alternatives": [],
    "current_deadline": null,
    "currently_due": [
      "business_profile.product_description",
      "business_profile.support_phone",
      "business_profile.url",
      "external_account",
      "tos_acceptance.date",
      "tos_acceptance.ip"
    ],
    "disabled_reason": "requirements.past_due",
    "errors": [],
    "eventually_due": [
      "business_profile.product_description",
      "business_profile.support_phone",
      "business_profile.url",
      "external_account",
      "tos_acceptance.date",
      "tos_acceptance.ip"
    ],
    "past_due": [],
    "pending_verification": []
  },
  ...
}

Mettre à jour le compte connecté

Mettez à jour l’objet Connected Account avec de nouvelles informations au fur et à mesure de sa progression dans votre flux d’inscription des utilisateurs. Effectuez un appel Update Account, identifiant le compte connecté par la valeur id que vous avez stockée précédemment.

Stripe valide chaque mise à jour d’un compte connecté. Mettez à jour le compte à chaque étape de l’inscription pour permettre à Stripe de valider les informations dès leur ajout, pendant que vos utilisateurs poursuivent le processus d’inscription. Une fois que Stripe a confirmé l’acceptation de nos conditions d’utilisation du service, toute modification apportée au compte connecté déclenche une revérification. Par exemple, si vous modifiez le nom et l’identifiant du compte connecté, Stripe procède à une nouvelle vérification.

Lors de la mise à jour d’un compte connecté, vous devez gérer les erreurs de vérification ou les codes d’erreur HTTP renvoyés par l’API Accounts.

Gestion des vérifications

Lorsque les données du compte connecté sont soumises, Stripe les vérifie. Ce processus peut prendre quelques minutes ou quelques heures, selon la nature de la vérification. Au cours de ce processus, les fonctionnalités que vous avez demandées ont pour status pending.

État de la vérification

Vous pouvez récupérer l’état des fonctionnalités de votre compte connecté des manières suivantes :

Examen du hash des fonctionnalités de l’objet Account pour la fonctionnalité concernée.
Demandez des fonctionnalités directement à partir de l’API Capabilities et examinez l’état de la fonctionnalité concernée.
Écoutez les événements account.updated dans votre endpoint de webhook et inspectez le hash capabilities pour la fonctionnalité correspondante.

Une fois les vérifications terminées, une fonctionnalité devient active et disponible pour le compte connecté. Les vérifications de compte s’exécutent en permanence, et si une vérification ultérieure échoue, une fonctionnalité peut ne plus être active . Écoutez les événements account.updated pour détecter les changements d’état des fonctionnalités.

Confirmez que votre intégration Connect est conforme et opérationnelle en vérifiant que les paramètres charges_enabled et payouts_enabled du compte sont tous deux définis sur « true ». Vous pouvez utiliser l’API ou écouter les événements account.updated. Pour plus d’informations sur les autres champs pertinents, vérifiez le hash des exigences du compte. Vous ne pouvez pas confirmer l’intégration sur la base d’une seule valeur, car les états peuvent varier selon l’application et les politiques associées.

charges_enabled confirme que votre chemin de paiement complet (paiement et transfert) fonctionne correctement et détermine si les fonctions card_payments et transfers sont actives.
payouts_enabled détermine si votre compte connecté peut effectuer des virements vers un compte externe. En fonction de vos politiques en matière de risques, vous pouvez autoriser votre compte connecté à commencer à effectuer des transactions sans avoir activé les virements. À terme, vous devrez activer les virements pour verser des fonds sur vos comptes connectés.

Vous pouvez partir de la logique suivante pour définir un état récapitulatif à afficher pour votre compte connecté.

Ruby
# Set your secret key. Remember to switch to your live secret key in production.
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = 'sk_test_BQokikJOvBiI2HlWgH4olfQ2'


def account_state(account)
  reqs = account.requirements

  if reqs.disabled_reason && reqs.disabled_reason.include?("rejected")
    "rejected"
  elsif account.payouts_enabled && account.charges_enabled
    if reqs.pending_verification
      "pending enablement"
    elsif !reqs.disabled_reason && !reqs.currently_due
      if !reqs.eventually_due
        "complete"
      else
        "enabled"
      end
    else
      "restricted"
    end
  elsif !account.payouts_enabled && account.charges_enabled
    "restricted (payouts disabled)"
  elsif !account.charges_enabled && account.payouts_enabled
    "restricted (charges disabled)"
  elsif reqs.past_due
    "restricted (past due)"
  elsif reqs.pending_verification
    "pending (disabled)"
  else
    "restricted"
  end
end

accounts = Stripe::Account.list(limit: 10)

accounts.each do |account|
    puts "#{account.id} has state: #{account_state(account)}"
end

Gérer les erreurs de vérification

Gérez différemment les échecs de vérification selon votre flux d’inscription.

Remarque

Vous ne pouvez pas utiliser l’API pour répondre aux vérifications des risques de Stripe. Vous pouvez autoriser vos comptes connectés à répondre à l’aide de composants intégrés, d’une procédure d’inscription hébergée par Stripe ou de liens de rectification. Vous avez également la possibilité d’utiliser le Dashboard pour répondre à des vérifications des risques au nom de vos comptes connectés.

Écoutez l’événement account.updated. Si le compte contient des champs currently_due à l’arrivée de la date current_deadline, la fonctionnalité correspondante est désactivée et ces champs sont ajoutés à past_due.

Créez un formulaire donnant des instructions claires que le compte pourra utiliser pour corriger ses informations. Informez le compte, puis soumettez les informations corrigées à l’aide de l’API Accounts.

Si vous prévoyez de créer des flux personnalisés pour gérer l’ensemble de vos erreurs de vérification :

Consultez les informations concernant toutes les erreurs de vérification possibles et comment les gérer.
Tester les états de vérification.

Voir aussi

En savoir plus sur l’utilisation des comptes Custom.