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

# Refunds API

> Een Refund is een volledige of gedeeltelijke terugboeking van een betaling, uitgevoerd met Refund Payment. Het legt vast hoeveel er is overgemaakt, via welke provider en of het is gelukt.

Een Refund is een volledige of gedeeltelijke terugboeking van een betaling, uitgevoerd met [Refund Payment](https://docs.whop.com/nl/api-reference/payments/refund-payment.md). Het legt vast hoeveel er is overgemaakt, via welke provider en of het is gelukt.

Gebruik de Refunds API om de terugbetalingen van een betaling of van een volledig account weer te geven, en om één terugbetaling op te halen.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Refunds weergeven](https://docs.whop.com/nl/api-reference/refunds/list-refunds.md) | GET `/refunds` |
| [Refund ophalen](https://docs.whop.com/nl/api-reference/refunds/retrieve-refund.md) | GET `/refunds/{id}` |

## Attributen

**id** `string` *required*

Refund-ID, met prefix `rf_`.

**account\_id** `string | null` *required*

Het account dat de terugbetaling heeft uitgevoerd, met prefix `biz_`.

**amount** `object | null` *required*

Het terugbetaalde bedrag zoals het is verrekend, in de afrekeningsvaluta van de betaling, zodat pagina's met terugbetalingen kunnen worden verrekend met `refunded_amount` van de betaling. Omgerekend tegen de koers die gold toen de terugbetaling werd uitgevoerd, niet tegen de oorspronkelijke koers van de betaling. Alleen null als er geen wisselkoers is vastgelegd voor een verouderde betaling in meerdere valuta.

> [accordion] Eigenschappen
>
> **amount** `string` *required*
>
> Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is
> bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg
> afrondt.
>
> **currency** `string` *required*
>
> Valutacode volgens ISO 4217 van drie letters, in kleine letters.
>
> **decimals** `integer` *required*
>
> Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling
> zelf wordt uitgevoerd.
>
> **display\_decimals** `integer` *required*
>
> Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.

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

Wanneer de terugbetaling is aangevraagd, als ISO 8601-tijdstempel.

**failure\_message** `string | null` *required*

Een uitleg voor de verkoper over waarom de terugbetaling is mislukt, in de taal
van het verzoek. Null tenzij de terugbetaling is mislukt of geannuleerd.

**failure\_reason** `string | null` *required*

Waarom de terugbetaling is mislukt, genormaliseerd over providers heen. Null tenzij de terugbetaling is mislukt of geannuleerd.

Beschikbare opties: `bank_declined`, `expired_or_canceled_card`, `lost_or_stolen_card`, `insufficient_funds`, `charge_disputed`, `not_refundable`, `merchant_request`, `unknown`

**metadata** `object | null` *required*

Je eigen key-value-gegevens die bij het aanvragen van de terugbetaling zijn
toegevoegd.

**original\_amount** `object` *required*

Het terugbetaalde bedrag in de valuta die de verwerker heeft overgemaakt.

> [accordion] Eigenschappen
>
> **amount** `string` *required*
>
> Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is
> bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg
> afrondt.
>
> **currency** `string` *required*
>
> Valutacode volgens ISO 4217 van drie letters, in kleine letters.
>
> **decimals** `integer` *required*
>
> Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling
> zelf wordt uitgevoerd.
>
> **display\_decimals** `integer` *required*
>
> Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.

**payment\_id** `string` *required*

De betaling die deze terugbetaling terugdraait, met prefix `pay_`.

**provider** `string` *required*

De betaalprovider die de terugbetaling heeft verwerkt, zoals `paypal` of
`coinbase`.

**provider\_created\_at** `string | null` *required*

Wanneer de provider de terugbetaling heeft aangemaakt, als ISO
8601-tijdstempel.

**reason** `string | null` *required*

Waarom de terugbetaling is uitgevoerd, indien vastgelegd.

Beschikbare opties: `duplicate`, `fraudulent`, `requested_by_customer`, `expired_uncaptured_charge`, `dispute_alert`

**reference\_status** `string | null` *required*

Of er een trackingreferentie van het bankennetwerk beschikbaar is voor deze terugbetaling.

Beschikbare opties: `available`, `pending`, `unavailable`

**reference\_type** `string | null` *required*

Het soort trackingreferentie, zoals een acquirer reference number.

Beschikbare opties: `acquirer_reference_number`, `retrieval_reference_number`, `system_trace_audit_number`

**reference\_value** `string | null` *required*

De trackingreferentie waarmee de bank van de koper de terugbetaling kan
traceren.

**status** `string` *required*

Waar de terugbetaling bij de verwerker staat: `pending`, `requires_action`, `succeeded`, `failed` of `canceled`.

Beschikbare opties: `pending`, `requires_action`, `succeeded`, `failed`, `canceled`

**updated\_at** `string` *required*

Wanneer de terugbetaling voor het laatst is gewijzigd, als ISO
8601-tijdstempel.

**visa\_rdr** `boolean` *required*

True als het kaartnetwerk de terugbetaling heeft gestart via Rapid Dispute
Resolution.

```json Refund theme={null}
{
	"id": "rf_xxxxxxxxxxxxxx",
	"payment_id": "pay_xxxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"status": "succeeded",
	"amount": {
		"amount": "49.00",
		"currency": "usd",
		"decimals": 2,
		"display_decimals": 2
	},
	"original_amount": {
		"amount": "49.00",
		"currency": "usd",
		"decimals": 2,
		"display_decimals": 2
	},
	"provider": "stripe",
	"reason": "requested_by_customer",
	"failure_reason": null,
	"failure_message": null,
	"reference_type": "acquirer_reference_number",
	"reference_status": "available",
	"reference_value": "74000006259000123456789",
	"visa_rdr": false,
	"metadata": {
		"refund_id": "ref_8f2k1"
	},
	"provider_created_at": "2026-09-15T14:30:02.000Z",
	"created_at": "2026-09-15T14:30:00.000Z",
	"updated_at": "2026-09-15T14:30:05.000Z"
}
```


## Related topics

- [List refunds](https://docs.whop.com/nl/api-reference/legacy/refunds/list-refunds.md)
- [Retrieve refund](https://docs.whop.com/nl/api-reference/legacy/refunds/retrieve-refund.md)
- [Retrieve Refund](https://docs.whop.com/nl/api-reference/refunds/retrieve-refund.md)
