> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Lidmaatschappen

> Lees lidmaatschappen uit en wijzig de facturering ervan met de API, bijvoorbeeld door een abonnement te pauzeren of gratis dagen toe te voegen.

Een lidmaatschap is de actieve relatie tussen een gebruiker en een product. Het houdt toegang, factureringsstatus en verlengingsschema bij. Je maakt lidmaatschappen niet direct aan, want dat doet de checkout voor je. Zodra een lidmaatschap bestaat, kun je het uitlezen, de facturering pauzeren of opzeggen, gratis tijd geven of metadata bijwerken.

> [!TIP]
>
> De meeste apps hoeven lidmaatschappen helemaal niet te beheren. Gebruik deze methoden wanneer je beheertools, klantenservice-flows of selfservicedashboards bouwt waarmee gebruikers kunnen pauzeren of opzeggen.

## Levenscyclus in één oogopslag

| Actie | Methode | Wat het doet |
| - | - | - |
| Facturering pauzeren | [`memberships.pause`](https://docs.whop.com/nl/api-reference/memberships/pause-membership) | Stopt toekomstige verlengingen tot hervatting. Bestaande toegang blijft behouden. |
| Facturering hervatten | [`memberships.resume`](https://docs.whop.com/nl/api-reference/memberships/resume-membership) | Maakt een pauze ongedaan. |
| Opzeggen | [`memberships.cancel`](https://docs.whop.com/nl/api-reference/memberships/cancel-membership) | Aan het einde van de periode, of direct (standaard). |
| Opzegging herstellen | [`memberships.update`](https://docs.whop.com/nl/api-reference/memberships/update-membership) | Stuur `cancel_at_period_end: false` om een openstaande opzegging ongedaan te maken. |
| Gratis tijd geven | [`memberships.extend`](https://docs.whop.com/nl/api-reference/memberships/extend-membership) | Verschuift de volgende verlengingsdatum met N dagen. |
| De factureringsdag wijzigen | [`memberships.update`](https://docs.whop.com/nl/api-reference/memberships/update-membership) | Stuur `current_period_end` om de volgende verlenging te verplaatsen. Lidmaatschappen die elke 30, 60, 90 … 360 of 365 dagen worden gefactureerd, blijven op die dag van de maand verlengen. |
| Metadata bijwerken | [`memberships.update`](https://docs.whop.com/nl/api-reference/memberships/update-membership) | Werk metadata of andere schrijfbare velden bij. |

## Ophalen en weergeven

```typescript TypeScript theme={null}
const membership = await client.memberships.retrieve({ id: "mem_xxxxxxxxxxxxx" });

// List with auto-pagination
const memberships = await client.memberships.list({
  account_id: "biz_xxxxxxxxxxxxx",
});

for await (const item of memberships) {
  console.log(item);
}
```

```python Python theme={null}
membership = client.memberships.retrieve("mem_xxxxxxxxxxxxx")

for item in client.memberships.list(account_id="biz_xxxxxxxxxxxxx"):
    print(item)
```

```ruby Ruby theme={null}
membership = client.memberships.retrieve(id: "mem_xxxxxxxxxxxxx")

# list returns an Enumerable that pages for you and yields one membership at a time
client.memberships.list(account_id: "biz_xxxxxxxxxxxxx").each do |item|
  puts item
end
```

```rust Rust theme={null}
let membership = client
    .memberships
    .retrieve(&"mem_xxxxxxxxxxxxx".to_string(), None)
    .await?;

// List one page of memberships for an account
let memberships = client
    .memberships
    .list(
        &MembershipsListQueryRequest {
            account_id: Some("biz_xxxxxxxxxxxxx".to_string()),
            ..Default::default()
        },
        None,
    )
    .await?;

for item in memberships.data {
    println!("{item:?}");
}
```

```go Go theme={null}
membership, err := client.Memberships.Retrieve(context.TODO(), &whopsdk.RetrieveMembershipsRequest{
    ID: "mem_xxxxxxxxxxxxx",
})
if err != nil {
    log.Fatal(err)
}
fmt.Println(membership)

// List with auto-pagination
page, err := client.Memberships.List(context.TODO(), &whopsdk.ListMembershipsRequest{
    AccountID: whopsdk.String("biz_xxxxxxxxxxxxx"),
})
if err != nil {
    log.Fatal(err)
}

iter := page.Iterator()
for iter.Next(context.TODO()) {
    fmt.Println(iter.Current())
}
if err := iter.Err(); err != nil {
    log.Fatal(err)
}
```

## Pauzeren en hervatten

Pauzeren stopt de volgende factureringscyclus. De gebruiker behoudt de bestaande toegang tot de huidige periode afloopt, maar de verlenging wordt niet uitgevoerd. Geef `until` mee om een automatische hervatting in te plannen.

```typescript TypeScript theme={null}
await client.memberships.pause({
  id: "mem_xxxxxxxxxxxxx",
  until: "2026-09-01T00:00:00Z", // optional, resumes automatically
});

// Later
await client.memberships.resume({ id: "mem_xxxxxxxxxxxxx" });
```

```python Python theme={null}
client.memberships.pause(
    "mem_xxxxxxxxxxxxx",
    until="2026-09-01T00:00:00Z",  # optional, resumes automatically
)

client.memberships.resume("mem_xxxxxxxxxxxxx")
```

```ruby Ruby theme={null}
client.memberships.pause(
  id: "mem_xxxxxxxxxxxxx",
  until: "2026-09-01T00:00:00Z", # optional, resumes automatically
)

# Later
client.memberships.resume(id: "mem_xxxxxxxxxxxxx")
```

```rust Rust theme={null}
client
    .memberships
    .pause(
        &"mem_xxxxxxxxxxxxx".to_string(),
        &PauseMembershipsRequest {
            until: Some("2026-09-01T00:00:00Z".to_string()), // optional, resumes automatically
        },
        None,
    )
    .await?;

// Later
client.memberships.resume(&"mem_xxxxxxxxxxxxx".to_string(), None).await?;
```

```go Go theme={null}
_, err := client.Memberships.Pause(context.TODO(), &whopsdk.PauseMembershipsRequest{
    ID:    "mem_xxxxxxxxxxxxx",
    Until: whopsdk.String("2026-09-01T00:00:00Z"), // optional, resumes automatically
})
if err != nil {
    log.Fatal(err)
}

// Later
if _, err := client.Memberships.Resume(context.TODO(), &whopsdk.ResumeMembershipsRequest{
    ID: "mem_xxxxxxxxxxxxx",
}); err != nil {
    log.Fatal(err)
}
```

## Opzeggen

Er zijn twee opzegmodi. `cancel_at_period_end: true` behoudt de toegang tot de huidige verlengingsdatum en deactiveert dan. Laat het weg (of geef `false` mee) om de toegang direct in te trekken.

```typescript TypeScript theme={null}
// Cancel at the end of the current billing period
await client.memberships.cancel({
  id: "mem_xxxxxxxxxxxxx",
  cancel_at_period_end: true,
});

// Cancel immediately. Access ends now.
await client.memberships.cancel({
  id: "mem_xxxxxxxxxxxxx",
  cancel_at_period_end: false,
  reason: "Requested by customer",
});
```

```python Python theme={null}
# Cancel at the end of the current billing period
client.memberships.cancel(
    "mem_xxxxxxxxxxxxx",
    cancel_at_period_end=True,
)

# Cancel immediately. Access ends now.
client.memberships.cancel(
    "mem_xxxxxxxxxxxxx",
    cancel_at_period_end=False,
    reason="Requested by customer",
)
```

```ruby Ruby theme={null}
# Cancel at the end of the current billing period
client.memberships.cancel(
  id: "mem_xxxxxxxxxxxxx",
  cancel_at_period_end: true,
)

# Cancel immediately. Access ends now.
client.memberships.cancel(
  id: "mem_xxxxxxxxxxxxx",
  cancel_at_period_end: false,
  reason: "Requested by customer",
)
```

```rust Rust theme={null}
// Cancel at the end of the current billing period
client
    .memberships
    .cancel(
        &"mem_xxxxxxxxxxxxx".to_string(),
        &CancelMembershipsRequest {
            cancel_at_period_end: Some(true),
            ..Default::default()
        },
        None,
    )
    .await?;

// Cancel immediately. Access ends now.
client
    .memberships
    .cancel(
        &"mem_xxxxxxxxxxxxx".to_string(),
        &CancelMembershipsRequest {
            cancel_at_period_end: Some(false),
            reason: Some("Requested by customer".to_string()),
        },
        None,
    )
    .await?;
```

```go Go theme={null}
// Cancel at the end of the current billing period
_, err := client.Memberships.Cancel(context.TODO(), &whopsdk.CancelMembershipsRequest{
    ID:                "mem_xxxxxxxxxxxxx",
    CancelAtPeriodEnd: whopsdk.Bool(true),
})
if err != nil {
    log.Fatal(err)
}

// Cancel immediately. Access ends now.
_, err = client.Memberships.Cancel(context.TODO(), &whopsdk.CancelMembershipsRequest{
    ID:                "mem_xxxxxxxxxxxxx",
    CancelAtPeriodEnd: whopsdk.Bool(false),
    Reason:            whopsdk.String("Requested by customer"),
})
if err != nil {
    log.Fatal(err)
}
```

> [!NOTE]
>
> `cancel_at_period_end: true` zet `cancel_at_period_end` op het lidmaatschap op `true`. De gebruiker behoudt de toegang tot de verlenging, waarna het lidmaatschap wordt gedeactiveerd en `membership.updated` wordt verstuurd met `previous_attributes.status` ingesteld op de status die het verliet. Als je het veld weglaat, wordt de toegang direct ingetrokken, dus stuur het expliciet mee wanneer je aan het einde van de periode wilt opzeggen.

## Een opzegging herstellen

Als de gebruiker zich bedenkt voordat de periode afloopt, wis je de openstaande opzegging aan het einde van de periode met een update. Dit heeft geen effect als het lidmaatschap niet gepland stond om te worden opgezegd.

```typescript TypeScript theme={null}
await client.memberships.update({
  id: "mem_xxxxxxxxxxxxx",
  cancel_at_period_end: false,
});
```

```python Python theme={null}
client.memberships.update("mem_xxxxxxxxxxxxx", cancel_at_period_end=False)
```

```ruby Ruby theme={null}
client.memberships.update(id: "mem_xxxxxxxxxxxxx", cancel_at_period_end: false)
```

```rust Rust theme={null}
client
    .memberships
    .update(
        &"mem_xxxxxxxxxxxxx".to_string(),
        &UpdateMembershipsRequest {
            cancel_at_period_end: Some(false),
            ..Default::default()
        },
        None,
    )
    .await?;
```

```go Go theme={null}
if _, err := client.Memberships.Update(context.TODO(), &whopsdk.UpdateMembershipsRequest{
    ID:                "mem_xxxxxxxxxxxxx",
    CancelAtPeriodEnd: whopsdk.Bool(false),
}); err != nil {
    log.Fatal(err)
}
```

## Gratis dagen toevoegen

Geef de gebruiker extra tijd op de huidige periode. De volgende verlengingsdatum schuift `days` dagen op. Handig bij storingen, als gebaar van de klantenservice of als beloning voor doorverwijzingen.

```typescript TypeScript theme={null}
await client.memberships.extend({
  id: "mem_xxxxxxxxxxxxx",
  days: 7,
});
```

```python Python theme={null}
client.memberships.extend("mem_xxxxxxxxxxxxx", days=7)
```

```ruby Ruby theme={null}
client.memberships.extend(id: "mem_xxxxxxxxxxxxx", days: 7)
```

```rust Rust theme={null}
client
    .memberships
    .extend(
        &"mem_xxxxxxxxxxxxx".to_string(),
        &ExtendMembershipsRequest { days: 7 },
        None,
    )
    .await?;
```

```go Go theme={null}
if _, err := client.Memberships.Extend(context.TODO(), &whopsdk.ExtendMembershipsRequest{
    ID:   "mem_xxxxxxxxxxxxx",
    Days: 7,
}); err != nil {
    log.Fatal(err)
}
```

`days` accepteert 1 tot en met 1095 (3 jaar).

## Metadata bijwerken

Werk willekeurige metadata of andere schrijfbare velden op het lidmaatschap bij.

```typescript TypeScript theme={null}
await client.memberships.update({
  id: "mem_xxxxxxxxxxxxx",
  metadata: { internal_user_id: "user_12345", tier: "gold" },
});
```

```python Python theme={null}
client.memberships.update(
    "mem_xxxxxxxxxxxxx",
    metadata={"internal_user_id": "user_12345", "tier": "gold"},
)
```

```ruby Ruby theme={null}
client.memberships.update(
  id: "mem_xxxxxxxxxxxxx",
  metadata: { internal_user_id: "user_12345", tier: "gold" },
)
```

```rust Rust theme={null}
client
    .memberships
    .update(
        &"mem_xxxxxxxxxxxxx".to_string(),
        &UpdateMembershipsRequest {
            metadata: Some(HashMap::from([
                ("internal_user_id".to_string(), json!("user_12345")),
                ("tier".to_string(), json!("gold")),
            ])),
            ..Default::default()
        },
        None,
    )
    .await?;
```

```go Go theme={null}
if _, err := client.Memberships.Update(context.TODO(), &whopsdk.UpdateMembershipsRequest{
    ID: "mem_xxxxxxxxxxxxx",
    Metadata: map[string]any{
        "internal_user_id": "user_12345",
        "tier":             "gold",
    },
}); err != nil {
    log.Fatal(err)
}
```

## Luisteren naar levenscyclusevents

Abonneer je via [webhooks](https://docs.whop.com/nl/developer/guides/webhooks.md). Dit zijn de events die gedurende de levenscyclus worden verstuurd:

| Event | Wanneer het wordt verstuurd |
| - | - |
| [`membership.activated`](https://docs.whop.com/nl/api-reference/memberships/membership-activated) | Lidmaatschap wordt geldig (eerste aankoop of verlengingsbetaling slaagt). |
| [`membership.updated`](https://docs.whop.com/nl/api-reference/memberships/membership-updated) | Er is iets aan het lidmaatschap gewijzigd. Het werd ongeldig (mislukte betaling, directe opzegging, ingaande opzegging aan het einde van de periode, of de gebruiker vertrok). De gebruiker zette de opzegging aan of uit. De verkoper wijzigde de factureringsperiode, prijs of verlengingsdatum. `previous_attributes` bevat de oorspronkelijke waarden. Activeringen worden ook als `membership.updated` geleverd. |

Bij `pause` / `resume` / `extend` verandert de status van het lidmaatschap niet, dus wordt er geen activerings- of deactiveringsevent verstuurd. Als je wilt bevestigen dat de wijziging is gelukt, haal je het lidmaatschap na de aanroep op of poll je volgens je eigen schema.

## Volgende stappen

> [card] [Betalingen accepteren](https://docs.whop.com/nl/developer/guides/accept-payments.md)
>
> Waar lidmaatschappen vandaan komen. Eenmalige en terugkerende checkouts.

> [card] [Betaalmethoden opslaan](https://docs.whop.com/nl/developer/guides/save-payment-methods.md)
>
> Opgeslagen kaarten voor toekomstige verlengingen en off-session facturering.

> [card] [Luisteren naar webhooks](https://docs.whop.com/nl/developer/guides/webhooks.md)
>
> Reageer op activering, deactivering en het aan- of uitzetten van opzeggingen.

> [card] [API-referentie voor lidmaatschappen](https://docs.whop.com/nl/api-reference/memberships/membership)
>
> De volledige resource: velden, statussen en elk endpoint.


## Related topics

- [Rechten controleren](https://docs.whop.com/nl/developer/guides/ios/check-entitlements.md)
- [Migreren vanaf eerdere versies](https://docs.whop.com/nl/developer/api/migrate-from-previous-versions.md)
- [API-versies](https://docs.whop.com/nl/developer/api/versioning.md)
