Inscription hébergée par Stripe pour les comptes Custom

Le flux d’inscription Connect Onboarding pour les comptes Custom prend en charge les inscriptions complètes comme progressives. Upfront onboarding. Pour les inscriptions complètes, Connect Onboarding collecte les exigences eventually_due du compte, tandis que dans le cas d’une inscription progressive, ce sont les exigences currently_due qui sont collectées. Pour en savoir plus sur les avantages et inconvénients de ces deux options, veuillez consulter la documentation relative aux flux d’inscription.

L’exigence currently_due permet de ne demander à l’utilisateur que les informations immédiatement nécessaires à la vérification. L’exigence eventually_due inclut un plus grand nombre de questions afin de recueillir en une seule fois toutes les informations qui seront nécessaires à long terme.

En fonction des besoins de votre plateforme, transmettez soit la valeur currently_due, soit la valeur eventually_due dans le paramètre collection_options.fields de vos appels à l’API Account Links. Voici un exemple de requête :

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -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 \
  -d "collection_options[fields]"=eventually_due

La réponse à votre requête à l’API Account Links inclut une valeur pour la clé url. Redirigez votre utilisateur vers ce lien pour l’envoyer vers le flux. Les URL d’Account Link ne peuvent être utilisées qu’une seule fois, car elles donnent accès aux informations personnelles du titulaire du compte. Authentifiez l’utilisateur dans votre application avant de le rediriger vers cette URL. Si vous activez Collecter les informations de compte externe pour les comptes Custom dans vos paramètres d’activation des virements, ou si la fonctionnalité treasury est demandée, l’utilisateur doit configurer une authentification supplémentaire avec Stripe avant d’accéder au flux d’inscription.

Connect Onboarding vous demande de transmettre à la fois une return_url et une refresh_url afin de gérer tous les cas de redirection des utilisateurs vers votre plateforme. Il est important que vous les implémentiez correctement afin de fournir la meilleure expérience à vos utilisateurs.

return_url

Stripe émet une redirection vers cette URL lorsque l’utilisateur achève le processus d’inscription Connect Onboarding ou clique sur Enregistrer pour plus tard à n’importe quel point du flux. Cela ne veut pas dire que toutes les informations ont été recueillies ou que toutes les exigences du compte ont été satisfaites. Cela signifie seulement que l’entrée et la sortie du flux ont fonctionné correctement.

Aucun état n’est transmis via cette URL. Une fois qu’un utilisateur est redirigé vers votre return_url, vérifiez l’état de l’attribut requirements de son compte. Vous pouvez écouter les webhooks account.updated ou récupérer l’objet Account et vérifier l’état de son attribut requirements. Pour plus d’informations, consultez l’étape 4 ci-dessous.

refresh_url

Votre utilisateur sera redirigé vers l’URL refresh_url dans les cas suivants :

• Le lien a expiré (quelques minutes après la création du lien)
• Le lien a déjà été utilisé (l’utilisateur a rafraîchi la page ou cliqué sur le bouton avant ou arrière)
• Le lien a été partagé dans une application tierce, telle qu’un client de messagerie, qui tente d’accéder à l’URL pour afficher un aperçu. De nombreux clients visitent automatiquement les liens, ce qui entraîne leur expiration

Pour une expérience optimale, votre URL refresh_url doit déclencher une méthode permettant à votre serveur d’appeler à nouveau Account Links avec les mêmes paramètres, et de rediriger l’utilisateur vers le flux Connect Onboarding.

Configurez votre intégration pour écouter les changements des exigences du compte, si ce n’est pas déjà fait. Pour ce faire, nous vous recommandons d’utiliser des webhooks. Vous pouvez tester la gestion des nouvelles exigences (et la désactivation des paiements et virements qui peut en résulter) en utilisant nos cartes dotées de déclencheurs pour le mode test.

Lorsque vos comptes connectés seront concernés par de futures mises à jour des exigences, nous vous en informerons.

Si vous utilisez l’inscription intégrée ou hébergée par Stripe, vous pouvez collecter des informations de manière proactive afin de satisfaire les exigences futures. Pour l’inscription intégrée, incluez l’attribut collectionOptions dans le composant d’inscription intégrée. Pour l’inscription hébergée par Stripe, spécifiez le paramètre collection_options lors de la création des liens de compte.

En fonction des besoins de votre application en matière de vérification, redirigez l’utilisateur vers Connect Onboarding si nécessaire pour satisfaire les exigencescurrently_due ou eventually_due décrites dans l’étape 1. Vous pouvez vous en servir comme d’un signal déterminant quand renvoyer votre utilisateur vers le flux. Veuillez noter que quand vous utilisez Connect Onboarding, vous n’avez pas à vous préoccuper de la nature des exigences ; dès l’instant où vous renvoyez l’utilisateur vers Connect Onboarding, les informations appropriées sont collectées.

Par exemple, si votre utilisateur commet une erreur de saisie et que ses informations ne peuvent être vérifiées, il peut être invité à fournir une pièce d’identité (par exemple, un permis de conduire pour les États-Unis). Dès l’instant où vous renvoyez cet utilisateur vers Connect Onboarding, il est invité à charger le document approprié à des fins de vérification.

Jusqu’à présent, nous avons essentiellement évoqué les cas où l’utilisateur est invité par le flux d’inscription Connect Onboarding à fournir de nouvelles informations. Le flux Connect Onboarding prend également en charge les mises à jour d’informations existantes initiées par l’utilisateur via le paramètre type de l’API Account Link. Le paramètre type n’accepte que deux valeurs : account_onboarding ou account_update.

account_onboarding

Cette valeur du paramètre type fournit un formulaire permettant de remplir les exigences restantes. Vous pouvez vous en servir pour l’inscription d’un nouvel utilisateur ou lorsqu’un utilisateur doit remplir de nouvelles exigences, par exemple lorsque l’utilisateur a déjà fourni les informations requises, mais que de nouvelles informations sont nécessaires suite à la demande d’une nouvelle fonctionnalité. Dans ce type de cas, dirigez l’utilisateur vers ce mode afin de collecter uniquement les informations dont vous avez besoin.

account_update

Cette valeur du paramètre type affiche les attributs déjà renseignés de l’objet Account et permet à votre utilisateur de modifier des informations existantes. Fournissez sur le site Web de votre plateforme un Account Link type=account_update pour que vos utilisateurs puissent procéder eux-mêmes aux modifications (en cas de changement d’adresse, par exemple). Nous vous suggérons d’intituler le lien « Modifier mon profil » ou « Mettre à jour mes informations de vérification ».