Skip to main content
Envoyez des versements directement à vos sous-comptes depuis le solde de votre plateforme. Les sous-comptes doivent effectuer la vérification d’identité et ajouter une méthode de versement avant de pouvoir recevoir des fonds.
1

Effectuer la vérification KYC

Avant de pouvoir recevoir des versements, un utilisateur doit effectuer la vérification d’identité (KYC). Utilisez le parcours d’onboarding de compte hébergé pour guider les utilisateurs dans cette démarche :
Redirigez l’utilisateur vers l’url renvoyée dans la réponse. Une fois la vérification terminée, il sera redirigé vers votre return_url.
2

Ajouter une méthode de versement

Avant de créer un versement, le compte a besoin d’une méthode de versement. Montez l’élément Withdraw avec un jeton d’accès pour le sous-compte. Il liste les méthodes de versement du compte et en collecte une nouvelle s’il n’en existe aucune :
Générez l’accessToken sur votre serveur pour le sous-compte, comme indiqué dans Activer les versements des sous-comptes. Vous pouvez aussi envoyer l’utilisateur vers le portail de versement hébergé. Pour n’accepter un compte PayPal qu’après que son titulaire s’est connecté pour prouver qu’il en est propriétaire, connectez une méthode de versement PayPal.
3

Obtenir la méthode de versement par défaut

Listez les méthodes de versement du sous-compte et trouvez celle qui a is_default: true :
4

Créer un versement

La version d’API 2026-11-03 et les suivantes exigent un devis. Appelez d’abord POST /payouts/quotes avec le compte, la méthode de versement, le montant, la devise et la vitesse que vous allez soumettre :
Remplacez QUOTE_TOKEN_FROM_RESPONSE ci-dessous par le quote_token renvoyé et soumettez la requête avant expires_at. Si une requête de versement expire, réessayez avec la même Idempotency-Key de versement et le jeton d’origine. Utilisez une clé différente pour la requête de devis.
Dans cet exemple :
  • account_id est le sous-compte à qui verser les fonds
  • amount est le montant du versement (100,00 USD) - les frais seront déduits de ce montant
  • currency est le code de devise ISO
  • payout_method_id est l’ID de la méthode de versement à utiliser (issu de l’étape 3)
La requête renverra une erreur si le montant dépasse le solde disponible.

Prendre en charge les frais de versement de vos sous-comptes

Par défaut, les frais de versement sont déduits du solde du sous-compte. Vous pouvez choisir de prendre ces frais en charge depuis le solde de votre plateforme en définissant platform_covers_fees sur true à la fois dans la requête de devis et dans la requête de versement :
Lorsque platform_covers_fees vaut true, le sous-compte reçoit l’intégralité du montant du versement et les frais sont débités du solde de votre plateforme. Cela nécessite que la politique de prise en charge des frais de votre plateforme couvre la méthode de versement, ou une clé API autorisée à gérer les frais de vos sous-comptes.

Référence de l’API

API Create Payout

Consultez la référence complète de l’API pour la création de versements

Payer les sous-comptes

Transférez des fonds vers vos sous-comptes

Afficher le portail de versement

Permettez à vos utilisateurs de retirer leurs fonds