Voorbeeld
Maak een account aan voor het subaccount:emailis het e-mailadres van het subaccount. Whop gebruikt het om het subaccount te identificeren en belangrijke meldingen te versturen.- De Account API-sleutel bepaalt welk platformaccount eigenaar is van het subaccount.
titleis de verplichte weergavenaam van het subaccount.external_idis het eigen ID van je platform voor dit subaccount, bijvoorbeeld je winkel-ID. Elk ID hoort bij één subaccount, en je kunt het account er later mee opzoeken.metadatabevat aangepaste key-valueparen, zoalsseller_tier, een classificatie of niveau voor het subaccount (bijv. “bronze”, “silver” of “gold”).- Het antwoord bevat een
account.idwaarmee je in toekomstige API-aanroepen naar dit subaccount kunt verwijzen
Een subaccount vinden aan de hand van je ID
Geef je subaccounts weer metexternal_id om het account bij een van je records op te halen. Eindig de waarde met % om elk account op te halen waarvan het ID begint met een namespace die je hebt gekozen, zoals shopline:%. De vergelijking is hoofdlettergevoelig, _ wordt letterlijk vergeleken en % werkt alleen aan het einde, dus ID’s die je aanmaakt, mogen dit teken niet bevatten.
TypeScript
external_id in op een bestaand subaccount of wist het. Alleen je platform kan het wijzigen. Het subaccount kan het lezen, maar niet bewerken.
Een e-mailadres hergebruiken
Meerdere subaccounts kunnen één e-mailadres delen, zolang elk een eigenexternal_id heeft. Het aanmaken van een account is idempotent op het paar van e-mailadres en external_id:
- Nieuwe
external_id: Whop maakt een nieuw subaccount aan, ook wanneer het e-mailadres al in gebruik is. - Hetzelfde e-mailadres en dezelfde
external_id: Whop geeft het bestaande subaccount terug in plaats van een duplicaat aan te maken, dus herhaalpogingen zijn veilig. external_idal gebruikt met een ander e-mailadres: Whop geeft een409terug in plaats van een tweede account met dat ID aan te maken. Zie Het account achter een ID vervangen om het ID in hetzelfde verzoek naar het nieuwe account te verplaatsen.- Geen
external_id: Whop geeft het bestaande subaccount voor dat e-mailadres zonderexternal_idterug, als dat er is.
Eerdere versies van deze gids plaatsten
external_id in metadata. Whop accepteert het daar nog steeds in elke API-
versie, stelt external_id ermee in en geeft het terug in metadata. Het volgt dezelfde regels als het veld op het hoogste niveau,
inclusief de 409 wanneer een ander subaccount het al heeft, dus stuur reassign_external_id: true om er een te hergebruiken.
Als je metadata.external_id later wijzigt, verandert external_id niet. Gebruik Update Account om het te wijzigen. Nieuwe
integraties moeten het veld op het hoogste niveau versturen.Het account achter een ID vervangen
Wanneer je aan jouw kant een account opnieuw uitgeeft, bijvoorbeeld een winkel die naar een nieuwe eigenaar gaat, maak dan het nieuwe subaccount aan met dezelfdeexternal_id en reassign_external_id: true. Whop verplaatst het ID in hetzelfde verzoek naar het nieuwe subaccount in plaats van een 409 terug te geven.
TypeScript
- Het subaccount dat het ID had, wordt niet verwijderd of op een andere manier gewijzigd. Het blijft actief met
external_idingesteld opnull, behoudt zijnmetadataen saldo, en verstuurt eenaccount.updated-webhook. Verwijder het zelf als je het niet meer nodig hebt. - Als het aanmaken mislukt, blijft het ID waar het was.
- Het verzoek heeft zowel de permissie
company:updateop je platformaccount alscompany:create_childnodig, omdat het een bestaand subaccount wijzigt. - Een verzoek met hetzelfde e-mailadres en dezelfde
external_idals een bestaand subaccount geeft dat subaccount terug, ook wanneer de flag is ingesteld. - Het ID wordt alleen tussen je eigen subaccounts verplaatst.
external_id op het oude account en stel het daarna in op het andere. Update Account heeft geen reassign_external_id, en als je het ID instelt voordat je het wist, krijg je een 409.
Onboarding afronden
Als de ontvanger nog geen Whop-account heeft, stuur dan een onboardinglink voor het account nadat je het account hebt aangemaakt. Via die link voltooit de ontvanger de Know Your Customer-verificatie (KYC), waarna het account overboekingen en andere uitbetalingsflows kan ontvangen.- checkoutflows voor hen aanmaken met applicatievergoedingen.
- geld overmaken naar hun accountsaldo.
- hen geld laten opnemen met het uitbetalingsportaal.
Aan de slag
Voordat je subaccounts kunt inschrijven, moet je je platformaccount instellen:- Registreer een platformaccount: maak een account aan op whop.com/dashboard
- Genereer een Account API-sleutel: ga naar de pagina met je ontwikkelaarsinstellingen en genereer een Account API-sleutel
- Gebruik de API-sleutel voor authenticatie: met deze API-sleutel authenticeer je bij de huidige API en beheer je je subaccounts
Aangepaste metadata
Je kunt aangepaste metadata aan accounts koppelen wanneer je ze aanmaakt. Met metadata sla je aanvullende informatie over elk subaccount op als key-valueparen. Dit is handig voor:- Het bijhouden van niveaus of classificaties van subaccounts
- Het koppelen aan databaserecords van je platform
external_id.
API-referentie
API voor het aanmaken van accounts
Bekijk de volledige API-referentie voor het aanmaken van accounts en alle beschikbare parameters
Volgende stappen
Na het aanmaken van een Account voor een subaccount:Betalingen innen en verdelen
Kies tussen directe afschrijvingen en overboekingen
Uitbetalingsportaal weergeven
Laat subaccounts hun geld opnemen

