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

# Confirmation Tokens API

> Een Confirmation Token is een kortlevende verwijzing voor eenmalig gebruik naar een betaalmethode en factuurgegevens die van een koper zijn verzameld.

De response retourneert nooit de onderliggende betaalgegevens.

Whop Elements maken de token aan in je verzamelflow aan de kant van de koper en geven je het `ctok_`-ID, dat je vanaf je server naar de Payments API stuurt. Haal een token op om de preview van de betaalmethode en factuurgegevens weer te geven of om te controleren of de token nog bruikbaar is.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Confirmation Token ophalen](https://docs.whop.com/nl/api-reference/confirmation-tokens/retrieve-confirmation-token.md) | GET `/confirmation_tokens/{id}` |

## Attributen

**id** `string` *required*

**billing\_address** `object | null` *required*

Het verzamelde factuuradres, inclusief de naam op het adres. Null wanneer niet verzameld of zonder bearer-authenticatie met payment:basic:read op het account van de token.

> [accordion] Eigenschappen
>
> **city** `string | null` *required*
>
> De plaats.
>
> **country** `string | null` *required*
>
> De ISO 3166-1 alpha-2-landcode.
>
> **line1** `string | null` *required*
>
> De eerste adresregel.
>
> **line2** `string | null` *required*
>
> De tweede adresregel.
>
> **name** `string | null` *required*
>
> De naam op het adres.
>
> **postal\_code** `string | null` *required*
>
> De postcode.
>
> **state** `string | null` *required*
>
> De staat, provincie of regio.

**billing\_details** `object | null` *required*

Factuurpreview die bij het verzamelen is opgegeven: e-mailadres, naam, land en postcode.

> [accordion] Eigenschappen
>
> **country** `string | null` *required*
>
> ISO 3166-1 alpha-2-landcode.
>
> **email** `string | null` *required*
>
> E-mailadres dat werd opgegeven toen de methode werd verzameld.
>
> **name** `string | null` *required*
>
> Naam op de betaalmethode.
>
> **postal\_code** `string | null` *required*
>
> Postcode.

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

Wanneer de token is aangemaakt, als ISO 8601-tijdstempel.

**expires\_at** `string` *required*

Wanneer de token verloopt, als ISO 8601-tijdstempel. Tokens zijn voor eenmalig
gebruik en kortlevend.

**object** `string` *required*

Altijd `confirmation_token`.

**payment\_method\_preview** `object` *required*

Preview van de verzamelde methode, alleen voor weergave — nooit de onderliggende token.

> [accordion] Eigenschappen
>
> **id** `string | null` *required*
>
> De opgeslagen betaalmethode waarvan deze preview afkomstig is, of `null`
> wanneer de koper een nieuwe heeft opgegeven.
>
> **bank\_debit** `object`
>
> Aanwezig wanneer de categorie `bank_debit` is. Leeg totdat het account is belast.
>
> > [accordion] Eigenschappen
> >
> > **brand** `string`
> >
> > Kaartmerk in kleine letters, zoals `visa` of `mastercard`.
> >
> > **fingerprint** `string`
> >
> > Identificeert dit specifieke kaartnummer uniek. Komt overeen met de
> > `fingerprint` op elke betaalmethode die vanuit deze token is opgeslagen, zodat
> > je een kaart over meerdere pogingen heen kunt herkennen. Bij een wallet
> > identificeert dit de netwerktoken in plaats van de onderliggende kaart.
> >
> > **last4** `string`
> >
> > De laatste vier cijfers van de kaart.
>
> **card** `object`
>
> Gegevens van de kaart, wanneer de categorie `card` is.
>
> > [accordion] Eigenschappen
> >
> > **brand** `string`
> >
> > Kaartmerk in kleine letters, zoals `visa` of `mastercard`.
> >
> > **fingerprint** `string`
> >
> > Identificeert dit specifieke kaartnummer uniek. Komt overeen met de
> > `fingerprint` op elke betaalmethode die vanuit deze token is opgeslagen, zodat
> > je een kaart over meerdere pogingen heen kunt herkennen. Bij een wallet
> > identificeert dit de netwerktoken in plaats van de onderliggende kaart.
> >
> > **last4** `string`
> >
> > De laatste vier cijfers van de kaart.
>
> **category** `string` *required*
>
> De familie waartoe het type behoort.
>
> Beschikbare opties: `card`, `wallet`, `bank_debit`, `bank_transfer`, `voucher`, `redirect`, `crypto`, `balance`, `in_app_purchase`, `card_present`, `saved`
>
> **display\_name** `string` *required*
>
> Leesbaar label voor de methode, bijv. `Visa •••• 4242`.
>
> **saved** `object`
>
> Gegevens van de opgeslagen kaart, wanneer de categorie `saved` is. Afwezig bij een saldo.
>
> > [accordion] Eigenschappen
> >
> > **brand** `string`
> >
> > Kaartmerk in kleine letters, zoals `visa` of `mastercard`.
> >
> > **fingerprint** `string`
> >
> > Identificeert dit specifieke kaartnummer uniek. Komt overeen met de
> > `fingerprint` op elke betaalmethode die vanuit deze token is opgeslagen, zodat
> > je een kaart over meerdere pogingen heen kunt herkennen. Bij een wallet
> > identificeert dit de netwerktoken in plaats van de onderliggende kaart.
> >
> > **last4** `string`
> >
> > De laatste vier cijfers van de kaart.
>
> **type** `string` *required*
>
> Het type betaalmethode, bijv. `card`, `apple_pay`, `klarna`.
>
> **wallet** `object`
>
> Gegevens van de netwerktoken die de wallet heeft aangeleverd, wanneer de categorie `wallet` is.
>
> > [accordion] Eigenschappen
> >
> > **brand** `string`
> >
> > Kaartmerk in kleine letters, zoals `visa` of `mastercard`.
> >
> > **fingerprint** `string`
> >
> > Identificeert dit specifieke kaartnummer uniek. Komt overeen met de
> > `fingerprint` op elke betaalmethode die vanuit deze token is opgeslagen, zodat
> > je een kaart over meerdere pogingen heen kunt herkennen. Bij een wallet
> > identificeert dit de netwerktoken in plaats van de onderliggende kaart.
> >
> > **last4** `string`
> >
> > De laatste vier cijfers van de kaart.

**setup\_future\_usage** `string | null` *required*

Status van de toestemming om op te slaan die het element bij het verzamelen
toonde: `off_session`, `on_session` of `null`. Confirm mag alleen opslaan als
dat hier is bevestigd.

**status** `string` *required*

`pending` totdat de token wordt gebruikt, daarna `consumed`; `expired` zodra de korte levensduur is verstreken. Alleen een `pending`-token kan worden belast.

Beschikbare opties: `pending`, `consumed`, `expired`

```json ConfirmationToken theme={null}
{
	"id": "ctok_xxxxxxxxxxxxxx",
	"object": "confirmation_token",
	"status": "pending",
	"payment_method_preview": {
		"id": null,
		"type": "card",
		"category": "card",
		"display_name": "Visa •••• 4242",
		"card": {
			"brand": "visa",
			"fingerprint": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
			"last4": "4242"
		}
	},
	"setup_future_usage": "off_session",
	"billing_details": {
		"email": "buyer@example.com",
		"name": "Buyer Name",
		"country": "US",
		"postal_code": "78701"
	},
	"billing_address": null,
	"created_at": "2026-08-28T12:00:00.000Z",
	"expires_at": "2026-08-28T12:15:00.000Z"
}
```
