Skip to main content
Assurez-vous que les versements n’atteignent qu’un compte PayPal appartenant au titulaire. Le titulaire se connecte à PayPal au lieu de saisir une adresse e-mail, et Whop enregistre l’adresse e-mail fournie par PayPal dès que le nom correspond à sa configuration de versement.
Avant de commencer, vous avez besoin de :
  • Une clé API disposant des scopes payout:destination:read et payout:create_destination.
  • La connexion PayPal activée sur le compte. Contactez Whop pour l’activer. En attendant, supports_paypal_login vaut false et l’étape 2 renvoie 403.
  • Une configuration de versement terminée. Whop compare le nom qui y figure avec celui du compte PayPal.
  • Une page https vers laquelle PayPal renverra le titulaire, sur un domaine ajouté au compte ou à sa plateforme. Ajoutez-le avec Create Domain et verification: {}. Il n’est pas nécessaire que la vérification soit terminée. https://localhost fonctionne pour les tests.
  • Le SDK Whop 2.5.0 ou une version ultérieure, si vous utilisez un SDK.

Fonctionnement de la redirection

Tout se déroule dans le navigateur du titulaire, dans un seul onglet. Vous n’appelez jamais PayPal directement.
  1. Votre serveur démarre une session et obtient une authorize_url sur PayPal.
  2. Le navigateur du titulaire s’y rend, puis le titulaire se connecte et approuve.
  3. PayPal renvoie le navigateur vers Whop, qui lit l’adresse e-mail, le nom et le statut de vérification du compte.
  4. Whop envoie le navigateur vers votre return_url avec ?paypal_link_token=… ou ?error=….
  5. Votre serveur transmet le jeton à Whop, qui vérifie le nom et enregistre le moyen de versement.

  1. Trouver le moyen de versement

Listez les moyens de versement pris en charge et conservez l’id de celui qui a supports_paypal_login: true. Les SDK parcourent pour vous toutes les pages de résultats.

  1. Démarrer la connexion

Créez une session de liaison PayPal et redirigez le titulaire vers son authorize_url. La session expire au bout de 15 minutes, à expires_at.
Le navigateur revient vers votre return_url avec l’un des paramètres suivants : Si le titulaire termine après expires_at, ou après la suppression du domaine de return_url du compte, Whop ne peut pas le renvoyer vers votre page. Il voit alors une page « Invalid or expired link ».

  1. Enregistrer le moyen de versement

Sur votre serveur, créez le moyen de versement enregistré avec paypal_link_token à la place de fields. Utilisez les mêmes account_id, supported_payout_method_id et destination_currency que pour la session, car le jeton ne fonctionne qu’avec ceux-ci. Whop enregistre l’adresse e-mail PayPal et nomme le moyen de versement d’après elle.
La réponse correspond au nouveau moyen de versement (version abrégée) :
Vous pouvez désormais envoyer un versement vers ce moyen.

Si Whop refuse le compte

Whop répond 400 avec un message destiné au titulaire, par exemple en cas de nom ne correspondant pas. Affichez-le tel quel.
  • Le jeton reste valide après un refus : relancez donc une erreur temporaire avec le même jeton.
  • Si le message indique de connecter à nouveau PayPal, démarrez une nouvelle session une fois que le titulaire a corrigé le problème.
  • Un compte PayPal non vérifié ou une adresse e-mail non confirmée est tout de même enregistré.

Ce que voit le titulaire

L’écran de consentement de PayPal indique que Whop est l’application qui demande son adresse e-mail, son nom et son statut de vérification. Chaque redirection reste dans l’onglet qui a ouvert PayPal : si vous utilisez une fenêtre pop-up, votre page de retour doit donc notifier la fenêtre qui l’a ouverte, puis se fermer.

Étapes suivantes

Envoyer un versement

Effectuez un versement vers le moyen PayPal que vous venez d’enregistrer

Référence de l'API Payouts

Tous les endpoints relatifs aux versements et aux moyens de versement