Exemple
Créez un compte pour le sous-compte :emailest l’adresse e-mail du sous-compte. Whop l’utilise pour identifier le sous-compte et lui envoyer les notifications importantes.- La clé API Account détermine le compte de plateforme propriétaire du sous-compte.
titleest le nom d’affichage obligatoire du sous-compte.external_idest l’ID propre à votre plateforme pour ce sous-compte, par exemple l’ID de votre boutique. Chaque ID correspond à un seul sous-compte, et vous pouvez ensuite retrouver le compte grâce à lui.metadatacontient des paires clé-valeur personnalisées, commeseller_tier, une classification ou un niveau pour le sous-compte (par exemple “bronze”, “silver” ou “gold”).- La réponse inclut un
account.idque vous pouvez utiliser pour faire référence à ce sous-compte dans les appels API suivants
Retrouver un sous-compte à partir de votre ID
Listez vos sous-comptes avecexternal_id pour obtenir le compte correspondant à l’un de vos enregistrements. Terminez la valeur par % pour obtenir tous les comptes dont l’ID commence par un espace de noms de votre choix, comme shopline:%. La correspondance est sensible à la casse, _ est interprété littéralement et % ne fonctionne qu’en fin de valeur : les ID que vous créez ne peuvent donc pas le contenir.
TypeScript
external_id sur un sous-compte existant. Seule votre plateforme peut le modifier. Le sous-compte peut le lire mais pas le modifier.
Réutiliser une adresse e-mail
Plusieurs sous-comptes peuvent partager une même adresse e-mail, à condition que chacun ait unexternal_id distinct. La création d’un compte est idempotente sur la paire e-mail et external_id :
- Nouvel
external_id: Whop crée un nouveau sous-compte, même si l’e-mail est déjà utilisé. - Même e-mail et même
external_id: Whop renvoie le sous-compte existant au lieu de créer un doublon, les nouvelles tentatives sont donc sans risque. external_iddéjà utilisé avec un autre e-mail : Whop renvoie une erreur409au lieu de créer un second compte avec cet ID. Pour transférer l’ID vers le nouveau compte dans la même requête, consultez Remplacer le compte associé à un ID.- Pas d’
external_id: Whop renvoie le sous-compte existant sansexternal_idpour cet e-mail, s’il en existe un.
Les versions précédentes de ce guide plaçaient
external_id dans metadata. Whop l’y accepte toujours, quelle que soit la version de l’API,
définit external_id à partir de cette valeur et la renvoie dans metadata. Les mêmes règles que pour le champ de premier niveau s’appliquent,
y compris l’erreur 409 lorsqu’un autre sous-compte le possède déjà : envoyez donc reassign_external_id: true pour en réutiliser un.
Modifier metadata.external_id par la suite ne modifie pas external_id. Pour le modifier, utilisez Update Account. Les nouvelles
intégrations doivent envoyer le champ de premier niveau.Remplacer le compte associé à un ID
Lorsque vous réattribuez un compte de votre côté, par exemple une boutique qui change de propriétaire, créez le nouveau sous-compte avec le mêmeexternal_id et reassign_external_id: true. Whop transfère l’ID vers le nouveau sous-compte dans la même requête au lieu de renvoyer une erreur 409.
TypeScript
- Le sous-compte qui possédait l’ID n’est ni supprimé ni modifié d’une autre façon. Il reste actif avec
external_iddéfini surnull, conserve sesmetadataet son solde, et envoie un webhookaccount.updated. Supprimez-le vous-même si vous n’en avez plus besoin. - Si la création échoue, l’ID reste là où il était.
- La requête nécessite la permission
company:updatesur le compte de votre plateforme en plus decompany:create_child, car elle modifie un sous-compte existant. - Une requête avec le même e-mail et le même
external_idqu’un sous-compte existant renvoie ce sous-compte, même si elle définit l’indicateur. - L’ID ne peut être transféré qu’entre vos propres sous-comptes.
external_id sur l’ancien, puis définissez-le sur l’autre. Update Account ne dispose pas de reassign_external_id, et définir l’ID avant de l’effacer renvoie une erreur 409.
Finaliser l’onboarding
Si le destinataire n’a pas encore de compte Whop, envoyez-lui un lien d’onboarding après avoir créé le compte. Il effectue la vérification Know Your Customer (KYC) via ce lien, après quoi le compte peut recevoir des transferts et utiliser les autres parcours de versement.- créer pour lui des parcours de checkout avec des frais d’application.
- transférer des fonds vers le solde de son compte.
- lui permettre de retirer ses fonds avec le portail de versement.
Prise en main
Avant de pouvoir inscrire des sous-comptes, vous devez configurer le compte de votre plateforme :- Créez un compte de plateforme : créez un compte sur whop.com/dashboard
- Générez une clé API Account : accédez à la page des paramètres développeur et générez une clé API Account
- Utilisez la clé API pour l’authentification : cette clé API vous permet de vous authentifier auprès de l’API actuelle et de contrôler vos sous-comptes
Métadonnées personnalisées
Vous pouvez associer des métadonnées personnalisées aux comptes lors de leur création. Les métadonnées vous permettent de stocker des informations supplémentaires sur chaque sous-compte sous forme de paires clé-valeur. C’est utile pour :- Suivre les niveaux ou classifications des sous-comptes
- Établir un lien avec les enregistrements de la base de données de votre plateforme
external_id.
Référence de l’API
API Create Account
Consultez la référence complète de l’API pour la création de comptes et tous les paramètres disponibles
Étapes suivantes
Après avoir créé un compte pour un sous-compte :Encaisser et répartir des paiements
Choisissez entre débits directs et transferts
Afficher le portail de versement
Permettez aux sous-comptes de retirer leurs fonds

