Encaisser les paiements, puis effectuer les virements sur votre marketplace

Utilisez l’API /v2/core/accounts pour créer un compte connecté en spécifiant ledashboard et les responsabilités du compte connecté.

Si vous avez déjà collecté des informations pour vos comptes connectés, vous pouvez préremplir ces informations dans l’objet Account. Vous pouvez préremplir n’importe quelle information de compte, y compris des informations personnelles et professionnelles, des informations de compte externe, etc.

Connect Onboarding ne demande pas les informations préremplies. Cependant, il demande au titulaire du compte de confirmer les informations préremplies avant d’accepter le contrat d’utilisation du service Connect.

Lorsque vous testez votre intégration, préremplissez les informations du compte à l’aide des données de test.

Créer un lien de compte

Vous pouvez créer un lien de compte lien en appelant l’API Liens de compte v2 avec les paramètres suivants :

• account
• refresh_url
• return_url
• type = account_onboarding
• configurations =destinataire etmarchand

Rediriger votre utilisateur vers l’URL du lien de compte

La réponse Créer un lien de compte inclut une valeur url. Après avoir authentifié l’utilisateur dans votre application, redirigez-le vers cette URL pour l’envoyer dans le flux. Les URL de lien de compte sont temporaires et à usage unique uniquement, car elles permettent d’accéder aux informations personnelles de l’utilisateur du compte connecté. Si vous souhaitez préremplir les informations, vous devez le faire avant de générer le lien de compte. Une fois que vous avez créé le lien de compte, vous ne pouvez pas lire ou écrire les informations du compte connecté.

Gérer la redirection de l’utilisateur vers votre plateforme

Connect Onboarding exige de transmettre à la fois une return_url et une refresh_url pour gérer tous les cas où le compte utilisateur est redirigé vers votre plateforme.

return_url

Stripe émet une redirection vers cette URL lorsque l’utilisateur du compte connecté termine le flux d’inscription des utilisateurs. Cela ne signifie pas que tous les renseignements ont été recueillis ou qu’il n’y a pas d’exigences en attente sur le compte. Cela signifie simplement que le flux a été entré et sorti correctement.

Aucun état n’est transmis via cette URL. Une fois qu’un utilisateur est redirigé vers votrereturn_url, vérifiez l’état des exigences sur leur compte en procédant de l’une des manières suivantes :

• Écoutez les webhooksv2.core.account[exigences].updated.
• Appelez l’API Comptes v2 et inspectez l’objet renvoyé.

refresh_url

Stripe redirige votre utilisateur vers la refresh_url dans les cas suivants :

• Le lien a expiré (quelques minutes se sont écoulées depuis la création du lien).
• L’utilisateur a déjà utilisé l’URL (il a actualisé la page ou cliqué sur le bouton Précédent ou Suivant de son navigateur).
• Votre plateforme n’est plus en mesure d’accéder au compte.
• Le compte a été rejeté.

Configurez votre page actualiser_url pour déclencher une méthode sur votre serveur afin d’appeler les Liens de compte v2 à nouveau avec les mêmes paramètres, et rediriger l’utilisateur vers le nouveau lien.

Gérer les utilisateurs dont l’inscription n’est pas terminée

Un utilisateur qui est redirigé vers votrereturn_url n’a peut-être pas terminé le processus d’inscription. Utilisez l’endpoint /v2/core/accounts pour récupérer les comptes de l’utilisateur et vérifier si configuration.recipient.capabilities.stripe_balance.stripe_transfers.status est actif. Si l’état n’est pasactif et configuration.recipient.capabilities.stripe_balance.stripe_transfers.status_details.code est requirements_past_due, fournissez ides invites d’interface utilisateur pour permettre à l’utilisateur de continuer son inscription à travers un nouveau lien de compte. Pour les autres codes, traitez-les selon les besoins.

Créer une session Checkout Client and Server

Une session Checkout détermine ce que votre client voit sur la page de paiement hébergée par Stripe, tel que les postes de la facture, le montant et la devise de la commande, ainsi que les moyens de paiement acceptés.

Ajoutez à votre site Web un bouton de paiement qui appelle un endpoint côté serveur afin de créer une session Checkout.

Sur votre serveur, effectuez l’appel suivant à l’API Stripe. Après avoir créé une session Checkout, redirigez votre client vers l’URL renvoyée dans la réponse.

• line_items : cet argument spécifie les articles achetés par votre client. Ces articles sont affichés dans l’interface utilisateur hébergée par Stripe.
• success_url : cet argument assure la redirection de l’utilisateur une fois le paiement effectué.
• cancel_url : cet argument assure la redirection de l’utilisateur dès lors qu’il annule l’opération.
• payment_intent_data[application_fee_amount] : cet argument précise le montant que votre plateforme prévoit de prélever sur la transaction. Une fois le paiement capturé, le montant total du paiement est immédiatement transféré depuis la plateforme vers le compte connecté spécifié par le paramètre transfer_data[destination]. Ensuite, le montant application_fee_amount est à nouveau transféré vers la plateforme, et les frais Stripe sont déduits de ce montant.
• payment_intent_data[transfer_data][destination] : cet argument indique qu’il s’agit d’un paiement indirect. Un paiement indirect désigne un paiement traité sur la plateforme et pour lequel les fonds sont ensuite immédiatement et automatiquement transférés vers le solde en attente du compte connecté. Dans le cadre de notre exemple de location immobilière, nous voulons créer les conditions permettant au client de payer via la plateforme, et au propriétaire d’être payé par la plateforme.

Checkout utilise les paramètres de marque du compte de votre plateforme pour les paiements indirects. Pour en savoir plus, consultez Personnaliser l’image de marque.

Cette session crée un paiement indirect. Si vous souhaitez choisir à quel moment les transferts ont lieu ou transférer des fonds vers plusieurs bénéficiaires, utilisez plutôt des paiements et transferts distincts. Pour utiliser des paiements distincts, consultez Permettre à d’autres entreprises d’accepter directement des paiements.

Gérer les événements post-paiement Côté serveur

Stripe envoie un événement checkout.session.completed à l’issue du paiement. Utilisez un webhook pour recevoir ces événements et exécuter des actions en conséquence, comme l’envoi d’un e-mail de confirmation de commande à votre client, l’enregistrement de la vente dans une base de données ou le lancement d’un flux de livraison.

Nous vous conseillons d’écouter ces événements plutôt que d’attendre un rappel du client. Côté client, il arrive en effet que l’utilisateur ferme la fenêtre de son navigateur ou quitte l’application avant l’exécution du rappel. Avec certains moyens de paiement, la confirmation du paiement peut par ailleurs prendre entre 2 et 14 jours. Configurer votre intégration de manière à ce qu’elle écoute les événements asynchrones vous permettra d’accepter plusieurs moyens de paiement avec une seule intégration.

En plus de gérer l’événement checkout.session.completed, nous vous recommandons de gérer deux autres événements lorsque vous encaissez des paiements avec Checkout :

Ces événements incluent tous l’objet Checkout Session. Une fois le paiement effectué, l’état sous-jacent du PaymentIntent passe de processing à succeeded.