active, trialing, past_due, enzovoort), de huidige periode, openstaande annuleringen, aangepaste metadata en de softwarelicentiesleutel wanneer het product licenties bevat.
Gebruik de Memberships API om de lidmaatschappen van een account of je eigen lidmaatschappen weer te geven, er een op te halen via ID of licentiesleutel, een ontvanger uit te nodigen om lid te worden via een gratis variant, en de levenscyclus te beheren: direct of aan het einde van de periode annuleren, een geplande annulering terugdraaien, het innen van betalingen pauzeren en hervatten, toegang verlengen of opnieuw activeren, een promotiecode of affiliate toepassen, de verlengingsfrequentie wijzigen, toegang opnieuw synchroniseren, een overdrachtslink genereren en metadata bijwerken.
Vervangt de Legacy-resource Memberships. Bestaande Legacy-integraties blijven werken; zie API-versies voor de stabiliteitsgarantie.
Endpoints
Attributen
Het account (verkoper) waartoe dit lidmaatschap behoort.
Eigenschappen
Eigenschappen
URL van de logoafbeelding van het account.
null wanneer het account er geen heeft ingesteld.Openbare route-identificatie van het account, gebruikt in het storefront-pad
whop.com/\{route}.De affiliatecommissie van het lidmaatschap.
null zonder affiliate, zonder affiliate:basic:read op het account, en altijd in webhooks.Eigenschappen
Eigenschappen
Of de commissie alleen over de eerste betaling van het lidmaatschap wordt uitbetaald of over al zijn betalingen.Beschikbare opties:
first_payment, all_paymentsDe commissie als vast bedrag in de valuta van het lidmaatschap, of
null bij een percentage.Eigenschappen
Eigenschappen
Het bedrag in hoofdeenheden, als exacte decimale string. Bijvoorbeeld:
"10.00" is tien dollar. Het is een string zodat geen enkele float het onderweg afrondt.Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de afschrijving zelf wordt uitgevoerd.
De procentuele commissie in procentpunten, dus
20 betekent 20%, of null bij een vast bedrag.Hoe het commissietarief is vastgesteld:
custom voor een tarief dat voor deze affiliate is ingesteld, member voor het affiliatetarief voor leden van het plan of product, global voor het wereldwijde affiliatetarief van het product, of marketplace voor een doorverwijzing via de Whop-marketplace.Beschikbare opties: custom, member, marketplace, globalOf de commissie een percentage of een vast bedrag is.Beschikbare opties:
flat_fee, percentageOf dit lidmaatschap affiliatecommissies uitbetaalt.
false betekent dat de affiliate op het lidmaatschap blijft staan maar niet langer wordt betaald.Aantal dagen tussen terugkerende afschrijvingen.
null voor niet-verlengende lidmaatschappen of lidmaatschappen met meerdere verlengingsschema’s.Of het lidmaatschap is ingesteld om te worden geannuleerd wanneer de huidige factureringsperiode eindigt. Alleen relevant voor terugkerende varianten.
De categorie die het lid heeft gekozen als reden voor het annuleren.
null wanneer er geen categorie is gekozen.Beschikbare opties: too_expensive, switching, missing_features, technical_issues, bad_experience, unused, other, testingWanneer de annulering is aangevraagd, of wanneer het lidmaatschap is geannuleerd als er geen aanvraagtijdstip is vastgelegd, als ISO 8601-tijdstempel.
null wanneer geen van beide is vastgelegd.Vrije toelichting die bij het annuleren is gegeven.
null wanneer er geen reden is opgegeven.Hoe verlengingen worden geïnd.
charge_automatically schrijft elke periode af van de opgeslagen betaalmethode; send_invoice mailt de koper elke periode een factuur. null wanneer niet ingesteld.Beschikbare opties: charge_automatically, send_invoiceWanneer de huidige factureringsperiode wordt verlengd, of wanneer een niet-verlengend lidmaatschap verloopt, als ISO 8601-tijdstempel.
null voor eenmalige aankopen zonder vervaldatum.Wanneer de huidige factureringsperiode begon, als ISO 8601-tijdstempel.
null wanneer er geen factureringsperiode is vastgelegd.Wanneer de toegang eindigt voor een lidmaatschap met een vaste vervaldatum, als ISO 8601-tijdstempel.
null wanneer het lidmaatschap geen vervaldatum heeft, zoals een verlengend lidmaatschap.De accounts van het lid op externe platforms, zoals Discord en Telegram. Leeg wanneer het lid er geen heeft gekoppeld.
null in webhooks.Eigenschappen
Eigenschappen
De gebruikers-ID van het lid op het platform, zoals een Discord-gebruikers-ID. Met het platform als prefix (
discord_\<external_id>) is het de external_account-waarde waarop List Memberships filtert.Het platform waarop het account van het lid staat.Beschikbare opties:
discord, telegramDe eigen annuleringsreden van het account die het lid heeft gekozen, zoals het lid die zag.
null wanneer het lid een standaardcategorie heeft gekozen of geen reden heeft opgegeven.De huidige vooruitbetaalde prijs van de variant, in de valuta van de variant. Een catalogusprijs, niet noodzakelijk wat de koper heeft betaald.
amount is "0.00" wanneer de eerste afschrijving gratis is.Eigenschappen
Eigenschappen
Het bedrag in hoofdeenheden, als exacte decimale string. Bijvoorbeeld:
"10.00" is tien dollar. Het is een string zodat geen enkele float het onderweg afrondt.Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de afschrijving zelf wordt uitgevoerd.
De softwarelicentiesleutel voor dit lidmaatschap. Alleen aanwezig wanneer het product een experience voor softwarelicenties bevat.
URL waar de koper kan inloggen om de facturering te beheren.
null zonder ledenrecord of tenzij de aanroeper de koper is of member:manage op het account heeft.De ledenrij van de aanroeper op het account. Alleen aanwezig wanneer het lidmaatschap van de aanroeper is;
null bij leesbewerkingen aan de verkoperszijde.Eigenschappen
Eigenschappen
Waartoe het lid toegang heeft op het account:
customer voor betalende leden, admin voor teamleden, no_access zodra elke toekenning is verlopen.Beschikbare opties: no_access, admin, customerWanneer het lid voor het laatst de content van het account heeft geopend, als ISO 8601-tijdstempel.
null als dat nooit is gebeurd.Het ledenrecord van de koper op het account, met prefix
mber_. null wanneer het lidmaatschap geen ledenrecord heeft, zoals een niet-geclaimd lidmaatschap.Aangepaste sleutel-waardeparen die op het lidmaatschap zijn opgeslagen, vaak gebruikt voor softwarelicenties.
De meest recente levenscyclusgebeurtenis van het lidmaatschap, zoals
renewing_on of canceled_on. Combineer dit met most_recent_action_at. null wanneer er niets is vastgelegd.Beschikbare opties: canceled_on, finished_split_pay_at, canceling_on, ending_on, renewing_on, past_due, next_payment_attempt, paused_at, trial_ends_at, unresolved_at, trial_canceling_onWanneer
most_recent_action plaatsvond of gepland staat, als ISO 8601-tijdstempel. Een toekomstig tijdstip voor aankomende gebeurtenissen zoals renewing_on. null wanneer er geen actie is vastgelegd.Het telefoonnummer van de koper dat voor dit lidmaatschap is vastgelegd, of
null. Het nummer dat bij de checkout is verzameld (of geverifieerd) wanneer telefoonverzameling van de verkoper is ingeschakeld; valt terug op het accountnummer van de koper als die het met deze verkoper heeft gedeeld.De promotiecode die korting geeft op dit lidmaatschap, met prefix
promo_. null wanneer er geen is toegepast. Ingesteld bij de checkout of via Apply Promo Code to Membership.De verlengingsprijs van de variant, in de valuta van de variant, na een eventuele promotiecode die nog van toepassing is. Een lidmaatschap dat in de lokale valuta van de koper wordt gefactureerd, wordt op elke factuurdatum deze prijs omgerekend tegen de wisselkoers in rekening gebracht.
null voor niet-verlengende lidmaatschappen.Eigenschappen
Eigenschappen
Het bedrag in hoofdeenheden, als exacte decimale string. Bijvoorbeeld:
"10.00" is tien dollar. Het is een string zodat geen enkele float het onderweg afrondt.Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de afschrijving zelf wordt uitgevoerd.
Betaalde termijnen die tot nu toe zijn geteld voor een lidmaatschap met gespreide betaling.
null wanneer het lidmaatschap geen gespreide betaling heeft, of voordat de eerste termijn is geteld.Termijnbetalingen die nodig zijn voordat het lidmaatschap stopt met factureren.
null wanneer het lidmaatschap geen gespreide betaling heeft.Factureringsstatus van het lidmaatschap.
active/trialing-lidmaatschappen geven toegang; past_due is de respijtperiode na een mislukte betaling; completed eenmalige aankopen behouden toegang; canceled/expired niet.Beschikbare opties: trialing, active, past_due, completed, canceled, expired, unresolvedWanneer het lidmaatschap voor het laatst is gewijzigd, als ISO 8601-tijdstempel. Geeft de meest recente wijziging aan het lidmaatschap zelf weer, zodat je kunt afstemmen met webhook-herhalingen, replays en backfills.
De koper, met prefix
user_. null wanneer de koper een ander bedrijf is of het lidmaatschap niet is geclaimd.Membership

