Effectuer un virement

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 plus facilement les informations dont Stripe a besoin pour vérifier l’identité de l’utilisateur. Dans le cadre du produit de questions/réponses qui rémunère les réponses fournies, le compte connecté représente l’auteur.

1. Personnaliser votre formulaire d’inscription

Dans les paramètres de votre plateforme, personnalisez votre formulaire d’inscription Express en modifiant la couleur et les logos présentés aux utilisateurs lorsqu’ils cliquent sur votre lien Connect.

Formulaire d’inscription Express par défaut

Paramètres de marque

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

Utilisez l’API /v1/accounts pour créer un compte connecté en spécifiant les propriétés du compte connecté ou le type de compte.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "controller[losses][payments]"=application \
  -d "controller[fees][payer]"=application \
  -d "controller[stripe_dashboard][type]"=express

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.

3. Créer un lien de compte

Créez un lien de compte avec les arguments 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

4. Rediriger votre utilisateur vers le lien de compte

La réponse à votre requête Account Links contient une valeur pour la clé url. Redirigez votre utilisateur vers ce lien. Les URL provenant de l’API Account Links sont temporaires et ne peuvent être utilisées qu’une seule fois, car elles donnent accès aux informations personnelles du titulaire du compte. Procédez à l’authentification de l’utilisateur dans votre application avant de le rediriger vers cette URL. Si vous souhaitez préremplir les informations, vous devez le faire avant de générer le lien de compte. Une fois le lien de compte créé, les opérations de lecture comme d’écriture ne seront plus possibles pour ce compte connecté.

5. Gérer la redirection de l’utilisateur vers 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 l’entrée de votre client dans le flux et sa sortie se sont déroulées correctement.

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 :

• En écoutant les événements 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 sa création).
• Le lien a déjà été utilisé (l’utilisateur a actualisé la page ou a cliqué sur le bouton Précédent ou Suivant du navigateur)
• 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.
• Votre plateforme n’est plus en mesure d’accéder au compte.
• Le compte a été rejeté.

Pour une expérience optimale, votre refresh_url devrait effectuer un nouvel appel à l’API Account Links sur votre serveur avec les mêmes paramètres et rediriger l’utilisateur vers le flux Connect Onboarding.

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

Un utilisateur redirigé vers votre return_url peut ne pas avoir terminé 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). Vous pourrez vérifier l’état du paramètre details_submitted sur son compte pour voir s’il a terminé son inscription.

Pour ajouter des fonds, accédez à la section Solde du Dashboard. Cliquez sur Ajouter des fonds à mon solde et sélectionnez la raison pour laquelle vous ajoutez des fonds sur votre compte.

Sélectionnez l’option Effectuer des virements vers des comptes connectés pour ajouter des fonds à vos comptes connectés. Si vous ajoutez des fonds à votre solde en vue de futurs remboursements et litiges ou pour régulariser le solde négatif de votre plateforme, sélectionnez Couvrir les soldes négatifs et consultez la page Ajouter des fonds à votre solde Stripe.

Vérifier votre compte bancaire

Effectuez le processus de vérification dans le Dashboard lorsque vous tentez d’ajouter des fonds depuis un compte non vérifié pour la première fois. Si votre compte bancaire n’est pas vérifié, vous devrez confirmer deux microversements de la part de Stripe. Ces versements apparaîtront sur votre relevé bancaire en ligne avec la description ACCTVERIFY dans un délai de 1 à 2 jours ouvrables.

Une fois que les microversements sont arrivés sur votre compte, Stripe vous envoie une notification dans le Dashboard et par e-mail. Pour terminer le processus de vérification, cliquez sur la notification Dashboard dans la section Solde, saisissez le montant des deux microversements, puis cliquez sur Vérifier le compte.

Créer une recharge

Une fois votre compte vérifié, vous pouvez créer une recharge pour ajouter des fonds au solde de votre compte.

curl https://api.stripe.com/v1/topups \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=2000 \
  -d currency=usd \
  -d description="Top-up for week of May 31" \
  -d statement_descriptor="Weekly top-up"

Lorsque vous transférez des fonds, un libellé de relevé bancaire apparaît sur votre relevé bancaire pour la transaction. Par défaut, le libellé est intitulé Recharge, mais vous pouvez personnaliser ce libellé et sa description interne.

Afficher les fonds

Vous pouvez consulter vos fonds dans le Dashboard en accédant à l’onglet Recharges de la page Solde. À chaque fois que vous ajoutez des fonds, un objet Top-up est créé avec un ID unique au format tu_XXXXXX, que vous pouvez voir dans la vue détaillée de la recharge.

Délai de règlement

US platforms add funds through ACH debit and can take 5-6 business days to become available in your Stripe balance. You can request a review of your account for faster settlement timing by contacting Stripe Support.

Selon votre ancienneté, il est possible que Stripe réduise automatiquement le délai de règlement.

Vous pouvez ajouter des fonds pour de futurs remboursements ou litiges, ou bien pour régulariser un solde négatif en effectuant des virements bancaires. Ces fonds sont disponibles sous 1 à 2 jours ouvrables.

Vous pouvez transférer les fonds disponibles vers un compte connecté à l’aide de l’API. Par exemple, effectuez l’appel suivant pour transférer 10 USD vers un compte :

curl https://api.stripe.com/v1/transfers \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d amount=1000 \
  -d currency="usd" \
  -d destination="{{CONNECTED_STRIPE_ACCOUNT_ID}}"

Par défaut, les fonds que vous transférez vers un compte connecté s’ajoutent au solde Stripe de ce compte et sont versés quotidiennement. Vous pouvez modifier librement la fréquence des virements dans le Dashboard.

Vous pouvez visualiser un compte et son solde depuis le Dashboard de votre compte.

Utilisez les tokens bancaires de test afin de simuler des flux pour les comptes, l’inscription, les virements et l’ajout de fonds.