Skip to main content
Et medlemskab er den aktive relation mellem en bruger og et produkt. Det holder styr på adgang, faktureringsstatus og fornyelsesplan. Du opretter ikke medlemskaber direkte, fordi checkout gør det for dig. Når et medlemskab findes, kan du læse det, sætte faktureringen på pause eller annullere den, give gratis tid eller opdatere metadata.
De fleste apps behøver slet ikke at administrere medlemskaber. Brug disse metoder, når du bygger administrationsværktøjer, kundesupportforløb eller selvbetjeningsdashboards, hvor brugere kan sætte på pause eller annullere.

Livscyklussen i overblik

Hent og list

Sæt på pause og genoptag

En pause stopper den næste faktureringscyklus. Brugeren beholder sin eksisterende adgang, indtil den aktuelle periode udløber, men fornyelsen udløses ikke. Send until for at planlægge en automatisk genoptagelse.

Annuller

Der er to annulleringstilstande. cancel_at_period_end: true bevarer adgangen indtil den aktuelle fornyelsesdato og deaktiverer derefter. Udelad den (eller send false) for at tilbagekalde adgangen med det samme.
cancel_at_period_end: true sætter cancel_at_period_end til true på medlemskabet. Brugeren beholder adgangen indtil fornyelsen, hvorefter medlemskabet deaktiveres, og membership.updated udløses med previous_attributes.status sat til den status, det forlod. Udelades feltet, tilbagekaldes adgangen med det samme, så send det eksplicit, når du vil annullere ved periodens udløb.

Fortryd en annullering

Hvis brugeren fortryder, før perioden udløber, kan du rydde den afventende annullering ved periodens udløb med en opdatering. Det har ingen effekt, hvis medlemskabet ikke var planlagt til at blive annulleret.

Tilføj gratis dage

Kompenser brugeren med ekstra tid i den aktuelle periode. Næste fornyelsesdato rykkes days frem. Nyttigt ved driftsforstyrrelser, som supportgestus eller som henvisningsbelønning.
days accepterer 1 til og med 1095 (3 år).

Opdater metadata

Opdater vilkårlige metadata eller andre skrivbare felter på medlemskabet.

Lyt efter livscyklus-events

Abonner via webhooks. Dette er de events, der udløses i løbet af livscyklussen: Ved pause / resume / extend skifter medlemskabets status ikke, så der udløses ingen aktiverings-/deaktiverings-event. Hvis du skal bekræfte, at ændringen lykkedes, så hent medlemskabet efter kaldet, eller poll efter din egen tidsplan.

Næste trin

Modtag betalinger

Hvor medlemskaber kommer fra. Engangs- og tilbagevendende checkouts.

Gem betalingsmetoder

Gemte kort til fremtidige fornyelser og fakturering uden for sessionen.

Lyt til webhooks

Reager på aktivering, deaktivering og til- og frakobling af annullering.

API-reference for medlemskaber

Hele ressourcen: felter, statusser og alle endpoints.