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

# Payouts API

> Payouts repræsenterer penge sendt fra en kontos eller brugers saldo til en ekstern destination, såsom en bankkonto, en wallet eller en anden gemt udbetalingsmetode.

Brug Payouts API'et til at oprette og følge udbetalinger, administrere gemte udbetalingsmetoder og vise forventede ankomstoplysninger for midler, der forlader Whop.

## Endpoints

| Endpoint | Anmodning |
| - | - |
| [Vis udbetalinger](https://docs.whop.com/da/api-reference/payouts/list-payouts.md) | GET `/payouts` |
| [Hent udbetaling](https://docs.whop.com/da/api-reference/payouts/retrieve-payout.md) | GET `/payouts/{id}` |
| [Vis gemte udbetalingsmetoder](https://docs.whop.com/da/api-reference/payouts/list-saved-payout-methods.md) | GET `/payouts/methods` |
| [Vis understøttede udbetalingsmetoder](https://docs.whop.com/da/api-reference/payouts/list-supported-payout-methods.md) | GET `/payouts/supported_methods` |
| [Opret udbetaling](https://docs.whop.com/da/api-reference/payouts/create-payout.md) | POST `/payouts` |
| [Annuller udbetaling](https://docs.whop.com/da/api-reference/payouts/cancel-payout.md) | POST `/payouts/{id}/cancel` |
| [Opret gemt udbetalingsmetode](https://docs.whop.com/da/api-reference/payouts/create-saved-payout-method.md) | POST `/payouts/methods` |
| [Opret PayPal-linksession](https://docs.whop.com/da/api-reference/payouts/create-paypal-link-session.md) | POST `/payouts/paypal_link_sessions` |
| [Opret udbetalingstilbud](https://docs.whop.com/da/api-reference/payouts/create-payout-quote.md) | POST `/payouts/quotes` |
| [Opdater gemt udbetalingsmetode](https://docs.whop.com/da/api-reference/payouts/update-saved-payout-method.md) | PATCH `/payouts/methods/{id}` |
| [Slet gemt udbetalingsmetode](https://docs.whop.com/da/api-reference/payouts/delete-saved-payout-method.md) | DELETE `/payouts/methods/{id}` |

## Attributter

**id** `string` *required*

Udbetalings-ID med præfikset `wdrl_`.

**amount** `string` *required*

Udbetalingsbeløbet i hele valutaenheder som en decimalstreng.

**cancelable** `boolean` *required*

Om `POST /payouts/\{id}/cancel` ville have effekt på denne udbetaling lige nu:
`true`, mens den er `in_review`, mens den er `processing`, uden at noget endnu
er indsendt til udbetalingsudbyderen, eller mens en indsendt udbetaling stadig kan
anmodes om annullering hos udbyderen. `false`, når pengene er ankommet, eller
udbetalingen allerede er afsluttet.

**conversion** `object | null` *required*

Hvordan saldoen blev konverteret til udbetalingsvalutaen, før udbetalingen blev sendt. `null`, når udbetalingen blev sendt fra en saldo i dens egen valuta.

> [accordion] Egenskaber
>
> **from\_amount** `string` *required*
>
> Beløbet, som konverteringen tog fra saldoen, som en decimalstreng.
>
> **from\_currency** `string` *required*
>
> Valutaen for den saldo, konverteringen tog beløbet fra.
>
> **rate** `number` *required*
>
> Konverteringskursen i enheder af udbetalingsvalutaen for hver enhed af `from_currency`. Et eventuelt konverteringsgebyr er inkluderet i denne kurs.

**created\_at** `string` *required*

Hvornår udbetalingen blev oprettet.

**currency** `string` *required*

Udbetalingsvaluta.

**destination\_amount** `string | null` *required*

Beløbet leveret i destinationsvalutaen som en decimalstreng.
Tildeles, når udbetalingen behandles, så det er `null` før da og på
udbetalinger uden en registreret konvertering.

**destination\_currency** `string | null` *required*

Valutaen, midlerne leveres i, hentet fra udbetalingsmetoden, når
udbetalingen oprettes. På en udbetaling finansieret af en konverteringsanmodning følger den
den afregningsudbetaling, der blev oprettet sammen med den — `GET /payouts`-rækken, der har denne
udbetalings id som `payout_request_id` — og er kun `null`, når der ikke findes nogen
afregningsudbetaling.

**estimated\_arrival** `string | null` *required*

Anslået tidspunkt, hvor midlerne bliver tilgængelige på destinationskontoen.

**exchange\_rate** `number | null` *required*

Vekselkurs fra udbetalingsvalutaen til destinationsvalutaen. Tildeles,
når udbetalingen behandles, så den er `null` før da og på udbetalinger
uden en registreret kurs.

**failure** `object | null` *required*

Hvorfor udbetalingen sluttede uden at betale, eller hvorfor den blev tilbageført efter afregning. Til stede på mislykkede, annullerede, afviste og tilbageførte udbetalinger; ellers `null`.

> [accordion] Egenskaber
>
> **code** `string | null` *required*
>
> Klassificeret fejlkode fra det vedligeholdte fejlkatalog.
>
> **funds\_returned\_at** `string | null` *required*
>
> Det effektive tidspunkt for den tilbageførsel, der satte midlerne tilbage på saldoen —
> `null`, hvis de aldrig forlod den eller endnu ikke er returneret. Angives først, når
> returneringen er bekræftet i hovedbogen; selve bogføringen i hovedbogen kan ske kort
> efter dette tidspunkt.
>
> **message** `string | null` *required*
>
> Menneskelæsbar forklaring på fejlen. Kaldere med `payout:destination:read` kan modtage tekst, der er tilpasset destinationen; andre kaldere får den generiske katalogbesked.

**fee\_amount** `string` *required*

Gebyret, der opkræves for udbetalingen, i udbetalingsvalutaen, som en decimalstreng.

**fee\_paid\_by** `string` *required*

Hvem der bar udbetalingsgebyret: kontoen selv eller dens overordnede platform.

Tilgængelige muligheder: `self`, `platform`

**markup\_fee** `string` *required*

Whops tillæg på udbyderens gebyr, i udbetalingsvalutaen, som en decimalstreng.
`"0.0"`, når der ikke gælder noget.

**metadata** `object` *required*

Nøgle-værdi-data, der tilknyttes ved oprettelsen og returneres ved hver læsning. Højst 50 nøgler,
nøglenavne på op til 40 tegn, strengværdier på op til 500 tegn.

**net\_amount** `string` *required*

Det planlagte nettobeløb til destinationen, i udbetalingsvalutaen: amount minus
fee\_amount minus markup\_fee, når fee\_paid\_by er `self`; lig med amount, når
platformen dækker gebyrerne. En udbetaling, der ender som afvist, annulleret eller mislykket,
leverede intet — de fleste beholder det planlagte tal, og `failure` angiver, hvor
midlerne er, men en annulleret udbetaling finansieret af en konverteringsanmodning kan i stedet rapportere
det afregnede resultat: `amount` angiver det, der blev på saldoen, gebyrerne er
nul, fordi der ikke blev opkrævet nogen, og `net_amount` er 0, fordi intet blev
leveret.

**notes** `string | null` *required*

Fritekstnoter tilføjet af den, der oprettede udbetalingen, eller `null`, når der ikke blev
angivet nogen. Maksimalt 255 tegn.

**object** `string` *required*

**payer\_name** `string | null` *required*

Navnet på den enhed, der behandler udbetalingen.

**payout\_method** `object | null` *required*

Den gemte udbetalingsmetode, der blev brugt. Kræver payout:destination:read; null uden det.

> [accordion] Egenskaber
>
> **nickname** `string | null` *required*
>
> Kaldenavn for den gemte udbetalingsmetode.
>
> **supported\_payout\_method** `object | null` *required*
>
> Visningsoplysninger for den understøttede udbetalingsmetode.
>
> > [accordion] Egenskaber
> >
> > **delivery\_type** `string` *required*
> >
> > Hvordan midlerne leveres til modtageren.
> >
> > Tilgængelige muligheder: `cash_pickup`, `bank_deposit`, `home_delivery`, `mobile_wallet`, `card`, `check`, `bill`, `cryptocurrency`, `unknown`
> >
> > **icon\_url** `string | null` *required*
> >
> > Ikon-URL for den understøttede udbetalingsmetode.
> >
> > **payer\_name** `string | null` *required*
> >
> > Visningsnavn for den understøttede udbetalingsmetode.
>
> **type** `string` *required*
>
> Den type udbetalingsmetode, udbetalingen brugte. `external` sendte midler ud af Whop. `whop_card` flyttede midler over på kontoens eget Whop Card.
>
> Tilgængelige muligheder: `external`, `whop_card`

**payout\_request\_id** `string | null` *required*

Udbetalingsanmodnings-ID med præfikset `cofr_`, returneret af `POST /payouts`. Match det med
den afregnede udbetaling i `GET /payouts`. Returnerer `null` for udbetalinger, der ikke er oprettet
af `POST /payouts`.

**source** `string | null` *required*

Hvordan udbetalingen blev oprettet. `automatic` betyder en planlagt automatisk udbetaling. `null`, når udbetalingen ikke har nogen registreret kilde.

Tilgængelige muligheder: `api`, `dashboard`, `automatic`

**speed** `string` *required*

Leveringshastighed for udbetalingen.

Tilgængelige muligheder: `standard`, `instant`

**statement\_descriptor** `string | null` *required*

Betalingsbeskrivelsen, der sendes med udbetalingen, eller `null`, hvis der ikke blev angivet nogen
beskrivelse. Når den er angivet, 5-80 udskrivbare ASCII-tegn.

**status** `string` *required*

Aktuel udbetalingsstatus.

Tilgængelige muligheder: `requested`, `in_review`, `processing`, `completed`, `reversed`, `canceled`, `failed`, `denied`

**status\_detail** `string` *required*

Den mest detaljerede maskinfase under `status` — for eksempel
`awaiting_provider_acceptance` vs. `in_transit` under `processing`, eller
konverteringsfasen under `requested`. Informativt ordforråd: værdier kan
tilføjes uden en versionsændring; `status` er den versionerede kontrakt.

**trace\_code** `string | null` *required*

Betalingsnetværkets reference for denne udbetaling, såsom et ACH-sporingsnummer, et RTP-
eller FedNow-end-to-end-ID, en wire-IMAD eller en SWIFT UETR. `null`, indtil
referencen er tilgængelig, og på udbetalinger, der ikke har nogen.

```json Payout theme={null}
{
	"id": "wdrl_xxxxxxxxxxxxx",
	"amount": "125.5",
	"cancelable": false,
	"conversion": null,
	"created_at": "2026-06-01T12:00:00Z",
	"currency": "usd",
	"destination_amount": "115.89",
	"destination_currency": "eur",
	"estimated_arrival": "2026-06-03T12:00:00Z",
	"exchange_rate": 0.9234,
	"failure": null,
	"fee_amount": "1.25",
	"fee_paid_by": "self",
	"markup_fee": "0.0",
	"metadata": {
		"batch_id": "2026-06-01"
	},
	"net_amount": "124.25",
	"notes": "March affiliate commissions",
	"object": "payout",
	"payer_name": "Whop Payments",
	"payout_request_id": "cofr_xxxxxxxxxxxxx",
	"payout_method": {
		"nickname": "Operating account",
		"type": "external",
		"supported_payout_method": {
			"delivery_type": "bank_deposit",
			"icon_url": "https://cdn.whop.com/bank.png",
			"payer_name": "Whop Payments"
		}
	},
	"source": "api",
	"speed": "standard",
	"status": "completed",
	"status_detail": "completed",
	"statement_descriptor": "MYCOMPANY",
	"trace_code": "021000021234567"
}
```


## Related topics

- [API-versioner](https://docs.whop.com/da/developer/api/versioning.md)
- [Payout created](https://docs.whop.com/da/api-reference/payouts/payout-created.md)
- [Payout reversed](https://docs.whop.com/da/api-reference/payouts/payout-reversed.md)
