> ## 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.

# Medlemskaber

> Læs medlemskaber, og ændr deres fakturering med API'et, f.eks. ved at sætte et abonnement på pause eller tilføje gratis dage.

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.

> [!TIP]
>
> 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

| Handling | Metode | Hvad den gør |
| - | - | - |
| Sæt fakturering på pause | [`memberships.pause`](https://docs.whop.com/da/api-reference/memberships/pause-membership) | Stopper fremtidige fornyelser, indtil der genoptages. Eksisterende adgang bevares. |
| Genoptag fakturering | [`memberships.resume`](https://docs.whop.com/da/api-reference/memberships/resume-membership) | Ophæver en pause. |
| Annuller | [`memberships.cancel`](https://docs.whop.com/da/api-reference/memberships/cancel-membership) | Ved periodens udløb eller med det samme (standard). |
| Fortryd annullering | [`memberships.update`](https://docs.whop.com/da/api-reference/memberships/update-membership) | Send `cancel_at_period_end: false` for at fortryde en afventende annullering. |
| Giv gratis tid | [`memberships.extend`](https://docs.whop.com/da/api-reference/memberships/extend-membership) | Rykker næste fornyelsesdato N dage frem. |
| Skift faktureringsdag | [`memberships.update`](https://docs.whop.com/da/api-reference/memberships/update-membership) | Send `current_period_end` for at flytte næste fornyelse. Medlemskaber, der faktureres hver 30., 60., 90. … 360. eller 365. dag, fortsætter med at forny på den dag i måneden. |
| Opdater metadata | [`memberships.update`](https://docs.whop.com/da/api-reference/memberships/update-membership) | Opdater metadata eller andre skrivbare felter. |

## Hent og list

```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)
}
```

## 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.

```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)
}
```

## 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.

```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` 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.

```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)
}
```

## 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.

```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` accepterer 1 til og med 1095 (3 år).

## Opdater metadata

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

```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)
}
```

## Lyt efter livscyklus-events

Abonner via [webhooks](https://docs.whop.com/da/developer/guides/webhooks.md). Dette er de events, der udløses i løbet af livscyklussen:

| Event | Hvornår den udløses |
| - | - |
| [`membership.activated`](https://docs.whop.com/da/api-reference/memberships/membership-activated) | Medlemskabet bliver gyldigt (første køb eller fornyelsesbetaling lykkes). |
| [`membership.updated`](https://docs.whop.com/da/api-reference/memberships/membership-updated) | Noget på medlemskabet er ændret. Det blev ugyldigt (mislykket betaling, øjeblikkelig annullering, annullering ved periodens udløb trådte i kraft, eller brugeren forlod det). Brugeren slog annullering til eller fra. Sælgeren redigerede faktureringsperioden, prisen eller fornyelsesdatoen. `previous_attributes` indeholder de værdier, der blev ændret fra. Aktiveringer leveres også som `membership.updated`. |

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

> [card] [Modtag betalinger](https://docs.whop.com/da/developer/guides/accept-payments.md)
>
> Hvor medlemskaber kommer fra. Engangs- og tilbagevendende checkouts.

> [card] [Gem betalingsmetoder](https://docs.whop.com/da/developer/guides/save-payment-methods.md)
>
> Gemte kort til fremtidige fornyelser og fakturering uden for sessionen.

> [card] [Lyt til webhooks](https://docs.whop.com/da/developer/guides/webhooks.md)
>
> Reager på aktivering, deaktivering og til- og frakobling af annullering.

> [card] [API-reference for medlemskaber](https://docs.whop.com/da/api-reference/memberships/membership)
>
> Hele ressourcen: felter, statusser og alle endpoints.
