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

# Refusioner og tvister

> Udsted refusioner, besvar tvister med dokumentation, og lyt efter chargeback-hændelser.

Der kan ske to ting, efter en betaling er gennemført. **Refusioner** er en tilbageførsel, som du (eller dit supportteam) udsteder med vilje. **Tvister** er chargebacks, som køberen indgiver hos sin bank. Du har ikke altid kontrol over, hvordan en tvist ender, men du kan svare med dokumentation.

> [!TIP]
>
> Abonner på [webhooks](https://docs.whop.com/da/developer/guides/webhooks.md) for `refund.created`, `refund.updated`, `dispute.created`, `dispute.updated` og `dispute_alert.created`, så du kan afstemme statusændringer uden polling.

## Refusioner

Refusioner tilbagefører en gennemført betaling. Whop behandler dem gennem den oprindelige betalingsbehandler. Status for det tilhørende medlemskab opdateres automatisk.

### Udsted en refusion

Opret refusioner for en betaling, ikke direkte på refusionsressourcen. Kald `payments.refund({ id })`. Udelad `partial_amount` for en fuld refusion, eller angiv den for en delvis refusion.

```typescript TypeScript theme={null}
import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: process.env.WHOP_API_KEY });

// Full refund
const fullRefund = await client.payments.refund({ id: "pay_xxxxxxxxxxxxx" });

// Partial refund
const partialRefund = await client.payments.refund({
  id: "pay_xxxxxxxxxxxxx",
  partial_amount: 5.0, // in payment currency, e.g. 5 USD
});
```

```python Python theme={null}
import os
from whop_sdk import Whop

client = Whop(token=os.environ["WHOP_API_KEY"])

# Full refund
full_refund = client.payments.refund("pay_xxxxxxxxxxxxx")

# Partial refund
partial_refund = client.payments.refund(
    "pay_xxxxxxxxxxxxx",
    partial_amount=5.0,
)
```

```ruby Ruby theme={null}
require "whop_sdk"

client = Whop_sdk::Client.new(token: ENV.fetch("WHOP_API_KEY"))

# Full refund
full_refund = client.payments.refund(id: "pay_xxxxxxxxxxxxx")

# Partial refund
partial_refund = client.payments.refund(
  id: "pay_xxxxxxxxxxxxx",
  partial_amount: 5.0,
)
```

```rust Rust theme={null}
use whop_sdk::prelude::*;

let config = ClientConfig {
    token: Some(std::env::var("WHOP_API_KEY").unwrap()),
    ..Default::default()
};
let client = Whop::new(config).expect("Failed to build client");

// Full refund
let full_refund = client
    .payments
    .refund(&"pay_xxxxxxxxxxxxx".to_string(), &RefundPaymentsRequest::default(), None)
    .await?;

// Partial refund
let partial_refund = client
    .payments
    .refund(
        &"pay_xxxxxxxxxxxxx".to_string(),
        &RefundPaymentsRequest {
            partial_amount: Some(5.0), // in payment currency, e.g. 5 USD
        },
        None,
    )
    .await?;
```

```go Go theme={null}
import (
    "context"
    "log"
    "os"

    whopsdk "github.com/whopio/whopsdk-go/v2"
    "github.com/whopio/whopsdk-go/v2/client"
    "github.com/whopio/whopsdk-go/v2/option"
)

client := client.NewWhop(option.WithToken(os.Getenv("WHOP_API_KEY")))

// Full refund
_, err := client.Payments.Refund(context.TODO(), &whopsdk.RefundPaymentsRequest{
    ID: "pay_xxxxxxxxxxxxx",
})
if err != nil {
    log.Fatal(err)
}

// Partial refund
_, err = client.Payments.Refund(context.TODO(), &whopsdk.RefundPaymentsRequest{
    ID:            "pay_xxxxxxxxxxxxx",
    PartialAmount: whopsdk.Float64(5.0), // in payment currency, e.g. 5 USD
})
if err != nil {
    log.Fatal(err)
}
```

Svaret er det opdaterede `Payment`-objekt. Feltet `refunded_amount` viser det samlede refunderede beløb. Du kan kalde `refund` flere gange for en betaling op til dens fulde beløb.

> [!NOTE]
>
> Påkrævet tilladelse: `payment:manage`. Tilføj den via [guiden til tilladelser](https://docs.whop.com/da/developer/guides/permissions.md), før du udgiver din app.

### Se refusioner

Refusioner har deres egen ressource, hvis du har brug for at slå dem op bagefter.

```typescript TypeScript theme={null}
const refund = await client.refunds.retrieve({ id: "ref_xxxxxxxxxxxxx" });

const refunds = await client.refunds.list({
  account_id: "biz_xxxxxxxxxxxxx",
});

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

```python Python theme={null}
refund = client.refunds.retrieve("ref_xxxxxxxxxxxxx")

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

```ruby Ruby theme={null}
refund = client.refunds.retrieve(id: "ref_xxxxxxxxxxxxx")

client.refunds.list(account_id: "biz_xxxxxxxxxxxxx").each do |item|
  puts item
end
```

```rust Rust theme={null}
let refund = client
    .refunds
    .retrieve(&"ref_xxxxxxxxxxxxx".to_string(), None)
    .await?;

let refunds = client
    .refunds
    .list(
        &RefundsListQueryRequest {
            account_id: Some("biz_xxxxxxxxxxxxx".to_string()),
            ..Default::default()
        },
        None,
    )
    .await?;

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

```go Go theme={null}
refund, err := client.Refunds.Retrieve(context.TODO(), &whopsdk.RetrieveRefundsRequest{
    ID: "ref_xxxxxxxxxxxxx",
})
if err != nil {
    log.Fatal(err)
}
fmt.Println(refund)

page, err := client.Refunds.List(context.TODO(), &whopsdk.ListRefundsRequest{
    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)
}
```

## Tvister

En tvist (chargeback) åbnes, når køberens bank anfægter en betaling. Du har en frist til at svare med dokumentation, før banken træffer afgørelse. Whop videresender tvisten til dig, du indsender dokumentation, banken afgør sagen, og tvisten lukkes.

### Hold øje med indkommende tvister

Tre hændelser, du skal abonnere på:

| Hændelse | Betydning |
| - | - |
| [`dispute_alert.created`](https://docs.whop.com/da/api-reference/dispute-alerts/dispute-alert-created) | Tvistadvarsel før en formel tvist. Nogle betalingsbehandlere giver besked på forhånd. Ikke alle advarsler bliver til en tvist. |
| [`dispute.created`](https://docs.whop.com/da/api-reference/disputes/dispute-created) | Formel tvist åbnet. Svarfristen begynder. |
| [`dispute.updated`](https://docs.whop.com/da/api-reference/disputes/dispute-updated) | Statusændringer (f.eks. fra `needs_response` til `under_review` og derefter `won` eller `lost`). |

### Vis og hent

```typescript TypeScript theme={null}
const disputes = await client.disputes.list({
  account_id: "biz_xxxxxxxxxxxxx",
});

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

const dispute = await client.disputes.retrieve({ id: "dspt_xxxxxxxxxxxxx" });
```

```python Python theme={null}
for item in client.disputes.list(account_id="biz_xxxxxxxxxxxxx"):
    print(item)

dispute = client.disputes.retrieve("dspt_xxxxxxxxxxxxx")
```

```ruby Ruby theme={null}
client.disputes.list(account_id: "biz_xxxxxxxxxxxxx").each do |item|
  puts item
end

dispute = client.disputes.retrieve(id: "dspt_xxxxxxxxxxxxx")
```

```rust Rust theme={null}
let disputes = client
    .disputes
    .list(
        &DisputesListQueryRequest {
            account_id: Some("biz_xxxxxxxxxxxxx".to_string()),
            ..Default::default()
        },
        None,
    )
    .await?;

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

let dispute = client
    .disputes
    .retrieve(&"dspt_xxxxxxxxxxxxx".to_string(), None)
    .await?;
```

```go Go theme={null}
page, err := client.Disputes.List(context.TODO(), &whopsdk.ListDisputesRequest{
    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)
}

dispute, err := client.Disputes.Retrieve(context.TODO(), &whopsdk.RetrieveDisputesRequest{
    ID: "dspt_xxxxxxxxxxxxx",
})
if err != nil {
    log.Fatal(err)
}
fmt.Println(dispute)
```

### Svar med dokumentation

Svar på tvister sker i to trin: forbered din dokumentation med `disputes.update`, og indsend den derefter med `disputes.submit`. Update er idempotent. Du kan redigere felterne, indtil du indsender.

```typescript TypeScript theme={null}
// Stage evidence (call as many times as needed)
await client.disputes.update({
  id: "dspt_xxxxxxxxxxxxx",
  evidence: {
    customer_name: "Jane Doe",
    customer_email_address: "jane@example.com",
    product_description: "Annual subscription to Acme Pro, purchased 2026-01-15.",
    service_date: "2026-01-15",
    refund_policy_disclosure: "Customer agreed to no-refunds policy at checkout.",
    notes: "Customer used the product 47 times across 8 sessions before disputing.",
  },
});

// Submit evidence to the processor. After this, you can no longer edit.
await client.disputes.submit({ id: "dspt_xxxxxxxxxxxxx" });
```

```python Python theme={null}
client.disputes.update(
    "dspt_xxxxxxxxxxxxx",
    evidence={
        "customer_name": "Jane Doe",
        "customer_email_address": "jane@example.com",
        "product_description": "Annual subscription to Acme Pro, purchased 2026-01-15.",
        "service_date": "2026-01-15",
        "refund_policy_disclosure": "Customer agreed to no-refunds policy at checkout.",
        "notes": "Customer used the product 47 times across 8 sessions before disputing.",
    },
)

client.disputes.submit("dspt_xxxxxxxxxxxxx")
```

```ruby Ruby theme={null}
# Stage evidence (call as many times as needed)
client.disputes.update(
  id: "dspt_xxxxxxxxxxxxx",
  evidence: {
    customer_name: "Jane Doe",
    customer_email_address: "jane@example.com",
    product_description: "Annual subscription to Acme Pro, purchased 2026-01-15.",
    service_date: "2026-01-15",
    refund_policy_disclosure: "Customer agreed to no-refunds policy at checkout.",
    notes: "Customer used the product 47 times across 8 sessions before disputing.",
  },
)

# Submit evidence to the processor. After this, you can no longer edit.
client.disputes.submit(id: "dspt_xxxxxxxxxxxxx")
```

```rust Rust theme={null}
// Stage evidence (call as many times as needed)
client
    .disputes
    .update(
        &"dspt_xxxxxxxxxxxxx".to_string(),
        &UpdateDisputesRequest {
            evidence: Some(DisputesUpdateDisputesRequestEvidence {
                customer_name: Some("Jane Doe".to_string()),
                customer_email_address: Some("jane@example.com".to_string()),
                product_description: Some(
                    "Annual subscription to Acme Pro, purchased 2026-01-15.".to_string(),
                ),
                service_date: Some("2026-01-15".to_string()),
                refund_policy_disclosure: Some(
                    "Customer agreed to no-refunds policy at checkout.".to_string(),
                ),
                notes: Some(
                    "Customer used the product 47 times across 8 sessions before disputing.".to_string(),
                ),
                ..Default::default()
            }),
        },
        None,
    )
    .await?;

// Submit evidence to the processor. After this, you can no longer edit.
client
    .disputes
    .submit(&"dspt_xxxxxxxxxxxxx".to_string(), None)
    .await?;
```

```go Go theme={null}
// Stage evidence (call as many times as needed)
_, err := client.Disputes.Update(context.TODO(), &whopsdk.UpdateDisputesRequest{
    ID: "dspt_xxxxxxxxxxxxx",
    Evidence: &whopsdk.UpdateDisputesRequestEvidence{
        CustomerName:           whopsdk.String("Jane Doe"),
        CustomerEmailAddress:   whopsdk.String("jane@example.com"),
        ProductDescription:     whopsdk.String("Annual subscription to Acme Pro, purchased 2026-01-15."),
        ServiceDate:            whopsdk.String("2026-01-15"),
        RefundPolicyDisclosure: whopsdk.String("Customer agreed to no-refunds policy at checkout."),
        Notes:                  whopsdk.String("Customer used the product 47 times across 8 sessions before disputing."),
    },
})
if err != nil {
    log.Fatal(err)
}

// Submit evidence to the processor. After this, you can no longer edit.
if _, err := client.Disputes.Submit(context.TODO(), &whopsdk.SubmitDisputesRequest{
    ID: "dspt_xxxxxxxxxxxxx",
}); err != nil {
    log.Fatal(err)
}
```

### Dokumentationsfelter

Alle felter er valgfrie, men jo mere du angiver, jo stærkere er dit svar. Almindelige felter:

| Felt | Hvad du skal angive |
| - | - |
| `customer_name` / `customer_email_address` | Identificerende oplysninger, du har registreret |
| `product_description` | Hvad kunden købte, i almindeligt sprog |
| `service_date` | Hvornår du leverede ydelsen (International Organization for Standardization (ISO) 8601) |
| `billing_address` | Adressen, der blev brugt ved checkout |
| `customer_communication_attachment` | E-mail- eller chattråde, der viser, at kunden var i dialog |
| `cancellation_policy_attachment` / `cancellation_policy_disclosure` | Din politik og bevis for, at kunden accepterede den |
| `refund_policy_attachment` / `refund_policy_disclosure` | Det samme for refusioner |
| `refund_refusal_explanation` | Hvorfor du ikke refunderede (f.eks. brug efter returfristen) |
| `access_activity_log` | Login- eller brugslogs, der beviser, at kunden brugte produktet |
| `uncategorized_attachment` | Alt andet relevant |

Vedhæftningsfelter tager en uploadet fil som `{ id: file.id }`. Upload først via [Files API](https://docs.whop.com/da/developer/guides/upload-files.md).

### Tvistens statusser

Tvisten bevæger sig gennem en tilstandsmaskine. Der er to faser: den tidlige advarselsfase (statusser med præfikset `warning_`, som vises via `dispute_alert.created`) og den formelle tvistfase. Alle statusser, SDK'et kan returnere:

| Status | Fase | Betydning |
| - | - | - |
| `warning_needs_response` | Advarsel | En tvistadvarsel er åben. Du kan foregribe den med en refusion eller et svar, før den eskalerer. |
| `warning_under_review` | Advarsel | Du har besvaret advarslen, og betalingsbehandleren afgør, om den skal eskaleres. |
| `warning_closed` | Advarsel | Advarslen blev løst uden at blive til en formel tvist. |
| `needs_response` | Tvist | Formel tvist åben. Indsend dokumentation, før svarfristen udløber. |
| `under_review` | Tvist | Du har indsendt dokumentation, og betalingsbehandleren træffer afgørelse. |
| `won` | Tvist | Midlerne forbliver hos dig. |
| `lost` | Tvist | Midlerne går tilbage til køberen. Whop tilbagefører den oprindelige betaling. |
| `prevented` | Tvist | Kunden fik refusion før en afgørelse. Afregnes som `lost`. |

> [!NOTE]
>
> Når en tvist er **tabt**, opretter Whop ikke automatisk en Refund-post, og du kan ikke selv oprette en. `payments.refund` afviser kald mod en tvistet betaling med `This payment has been disputed. Therefore, it cannot be refunded.` Brug den tabte tvist som sandhedskilde, og forvent ikke en `refund.created`-hændelse.

## Tilladelser

| Handling | Påkrævet tilladelse |
| - | - |
| Opret en refusion | `payment:manage` |
| Hent / vis refusioner | `payment:basic:read` |
| Hent / vis tvister | `payment:dispute:read` |
| Opdater eller indsend dokumentation | `payment:dispute` |

Tilføj dem via [guiden til tilladelser](https://docs.whop.com/da/developer/guides/permissions.md).

## Næste trin

> [card] [Modtag betalinger](https://docs.whop.com/da/developer/guides/accept-payments.md)
>
> Det flow, der opretter de betalinger, du senere refunderer eller forsvarer.

> [card] [Lyt efter webhooks](https://docs.whop.com/da/developer/guides/webhooks.md)
>
> Reager på refusions- og tvisthændelser på serversiden.

> [card] [Upload filer](https://docs.whop.com/da/developer/guides/upload-files.md)
>
> Upload dokumentationsbilag til svar på tvister.

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


## Related topics

- [Foretrukken afregningsvaluta](https://docs.whop.com/da/developer/payouts/preferred-settlement-currency.md)
- [Opkræv betalinger for underkonti](https://docs.whop.com/da/developer/platforms/collect-payments-for-subaccounts.md)
- [Oversigt over betalinger](https://docs.whop.com/da/developer/payments/overview.md)
