Permettre aux entreprises qui utilisent votre plateforme d’accepter directement des paiements

Installez les bibliothèques officielles de Stripe pour accéder à l’API depuis votre application :

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Lorsqu’un utilisateur (marchand ou fournisseur de services) s’inscrit sur votre plateforme, créez un compte d’utilisateur (appelé compte connecté) afin de pouvoir accepter des paiements de sa part et transférer des fonds vers son compte bancaire. Les comptes connectés représentent vos utilisateurs dans l’API de Stripe et permettent de collecter facilement les informations nécessaires pour vérifier leur identité. Dans notre exemple de création de boutique, le compte connecté représente l’entreprise qui configure sa boutique en ligne.

Créer un compte connecté et préremplir les informations

Utilisez l’API /v1/accounts pour créer un compte connecté. Vous pouvez le créer en utilisant les paramètres par défaut du compte connecté ou en spécifiant le type de compte.

curl -X POST https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

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 en appelant l’API Account Links avec les paramètres suivants :

• account
• refresh_url
• return_url
• type = account_onboarding

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

Rediriger votre utilisateur vers l’URL du lien de compte

La réponse à votre requête Account Links contient une valeur d’url de clé. Redirigez l’utilisateur vers ce lien pour l’introduire dans le flux. Les liens de compte sont temporaires et à usage unique, car ils donnent accès aux informations personnelles du titulaire du compte connecté. Authentifiez l’utilisateur dans votre application avant de le rediriger vers cette URL. Si vous souhaitez préremplir des informations, vous devez le faire avant de générer le lien de compte. Une fois le lien créé, les opérations de lecture comme d’écriture ne seront plus possibles pour ce compte.

Gérer le retour de l’utilisateur sur votre plateforme

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 d’offrir à vos utilisateurs une expérience optimale.

return_url

Stripe déclenche une redirection vers cette URL une fois que l’utilisateur a terminé son inscription Connect Onboarding. Ceci ne veut pas dire que toutes les informations ont été recueillies ni qu’il ne reste pas des conditions à remplir pour le compte, mais simplement que votre client est entré dans le flux et en est sorti sans que des soucis particuliers ne se posent.

Aucun état n’est transmis par cette URL. Une fois que l’utilisateur est redirigé vers votre return_url, vérifiez l’état du paramètre details_submitted sur son compte de l’une des manières suivantes :

• Écouter les webhooks account.updated
• Appeler l’API Accounts et inspecter l’objet renvoyé

refresh_url

Votre utilisateur est redirigé vers l’URL 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é le lien (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é

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.

Gérer les utilisateurs n’ayant pas finalisé leur inscription

Si un utilisateur est redirigé vers votre return_url, il peut ne pas avoir finalisé son inscription. Utilisez l’endpoint /v1/accounts pour récupérer ses données de compte et vérifier le paramètre charges_enabled. Si l’inscription du compte n’a pas été finalisée, affichez des invites pour encourager l’utilisateur à poursuivre son inscription. Il pourra achever l’activation de son compte grâce à un nouveau lien de compte généré par votre intégration. Pour vérifier qu’il a bien finalisé son inscription, examinez l’état du paramètre details_submitted sur son compte.

Accédez aux paramètres des moyens de paiement et activez ceux que vous souhaitez prendre en charge. Les paiements par carte bancaire sont activés par défaut, mais vous pouvez activer et désactiver les moyens de paiement de votre choix en fonction de vos besoins. Ce guide suppose que Bancontact, les cartes bancaires, EPS, iDEAL, Przelewy24, le prélèvement automatique SEPA et Sofort sont activés.

Avant que le formulaire de paiement ne s’affiche, Stripe évalue la devise, les restrictions en matière de moyens de paiement ainsi que d’autres paramètres pour dresser la liste des moyens de paiement pris en charge. Ceux qui augmentent le taux de conversion et qui sont les plus pertinents pour la devise et le lieu de résidence du client sont automatiquement priorisés. Ceux de moindre priorité ne sont accessibles que via un menu déroulant.

Intégrez Stripe Checkout comme formulaire de paiement directement sur votre site web ou redirigez les utilisateurs vers une page préconfigurée hébergée par Stripe pour accepter les paiements. Checkout prend en charge de nombreux moyens de paiement et affiche automatiquement les plus pertinents pour votre client. Vous pouvez également utiliser l’Element de paiement, un composant d’interface utilisateur préconfiguré intégré sous forme d’iframe dans votre formulaire de paiement, pour accepter plusieurs moyens de paiement avec une seule intégration front-end.

Page hébergée par Stripe

Formulaire intégré

Flux personnalisé

Créer une session Checkout Client-side Server-side

Une session Checkout détermine ce que votre client voit sur le formulaire de paiement intégré, notamment les postes de facture, le montant et la devise de la commande, ainsi que les moyens de paiement acceptés. Dans le cas de paiements directs, Checkout utilise les paramètres de branding du compte connecté. Pour en savoir plus, consultez la section Personnaliser l’image de marque.

Les utilisateurs ne sont pas responsables des paiements indirects et des paiements et transferts distincts. En revanche, c’est à eux qu’il revient de gérer les litiges concernant les paiements directs, et non à la plateforme.

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.

Command Line

cURL

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d mode=payment \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=1 \
  -d "payment_intent_data[application_fee_amount]"=123 \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/cancel"

• line_items : cet argument représente les postes achetés par votre client, qui apparaîtront dans l’interface utilisateur hébergée.
• 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.
• Stripe-Account : cet en-tête indique un paiement direct pour votre compte connecté. Avec les paiements directs, le compte connecté assume les frais Stripe, les remboursements et les contestations de paiement. La marque du compte connecté est utilisée dans Checkout, ce qui donne l’impression aux clients d’être en contact directement avec le marchand et non avec votre plateforme.
• (Facultatif) payment_intent_data[application_fee_amount] : cet argument précise le montant que votre plateforme prévoit de prélever sur la transaction. Après le traitement du paiement sur le compte connecté, le montant application_fee_amount est transféré sur la plateforme et les frais Stripe sont déduits du solde du compte connecté.

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 :

Événement	Description	Étapes suivantes
checkout.session.completed	Le client a autorisé le paiement en envoyant le formulaire Checkout.	Attendez que le paiement aboutisse ou échoue.
checkout.session.async_payment_succeeded	Le paiement du client a abouti.	Traitez la commande de biens ou de services de votre client.
checkout.session.async_payment_failed	Le paiement a été refusé, ou il a échoué pour une autre raison.	Contactez votre client par e-mail et demandez-lui de passer une nouvelle commande.

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

Testez votre flux de création de compte en créant des comptes et en utilisant OAuth. Testez vos paramètres de moyens de paiement pour vos comptes connectés en vous connectant à l’un de vos comptes test et en accédant aux paramètres de moyens de paiement. Testez votre tunnel de paiement à l’aide de vos clés et d’un compte test. Vous pouvez utiliser nos cartes de test pour tester votre tunnel de paiement et simuler divers scénarios.