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

# CardFields

> Drie afzonderlijk te mounten, PCI-geïsoleerde kaartvelden voor aangepaste lay-outs: nummer, vervaldatum en beveiligingscode. Maak het aan met `payments.create("cardFields")`, plaats elk veld, schakel je betaalknop in vanuit `onChange` en bevestig met `payments.createConfirmationToken()`. Kaartnummers blijven in gehoste velden.

> [!NOTE]
>
> Deze pagina documenteert `@whop/elements@1.10.0` en `@whop/elements-react@1.10.0`.

*Sinds `v1.0.0`.*

Wordt gemount binnen [`Payments`](https://docs.whop.com/nl/elements/latest/payments/overview). Maak het aan om een handle te krijgen en mount vervolgens de elementen op die handle. Roep `destroy()` aan om de subcontroller te verwijderen en zijn plek vrij te maken. Maak het opnieuw aan om een nieuwe handle te krijgen.

> [!NOTE]
>
> **Exclusief.**`CardFields` is een alternatief voor `PaymentElement` of `CardElement` in deze Payments-handle. Mount er één tegelijk. Verwijder het voordat je een ander mount.

## Voorbeeld

Een live, interactieve demo van de standaardindeling van deze subcontroller met voorbeeldgegevens:

Wordt gemount binnen een `WhopPayments`-scope. Dezelfde drie gehoste invoervelden als [`WhopCardElement`](https://docs.whop.com/nl/elements/latest/payments/card#swift), één voor één geplaatst binnen de content-builder, zodat jouw eigen lay-out bepaalt waar elk veld staat.

De provider voor afzonderlijk geplaatste kaartvelden. Wikkel het deel van je formulier dat ze bevat erin en plaats `CardNumberElement`, `CardExpiryElement` en `CardCvcElement` waar je lay-out ze nodig heeft.

## Voorbeeld

Draaiend in de React Native-voorbeeldapp:

[CardFields draaiend op Android, in de React Native-voorbeeldapp](https://app.revyl.ai/embed/4a22f507-3667-4162-b83f-1d7a7d4fa900?controls=0)

```tsx React theme={null}
import { WhopElements, Payments, CardFields, CardNumberElement, CardExpiryElement, CardCvcElement, BrandingElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Payments /* options */>
        <CardFields>
          <CardNumberElement />
          <CardExpiryElement />
          <CardCvcElement />
        </CardFields>
        <BrandingElement />
      </Payments>
    </WhopElements>
  );
}
```

```tsx React Native theme={null}
import { View } from 'react-native';
import {
  CardCvcElement,
  CardExpiryElement,
  CardFields,
  CardNumberElement,
  Payments,
} from '@whop/elements-react-native';

export function CardForm() {
  return (
    <Payments accountId="biz_xxxxxxxx" plan="plan_xxxxxxxx">
      <CardFields onChange={({ complete }) => console.log(complete)}>
        <CardNumberElement />
        <View style={{ flexDirection: 'row', gap: 8 }}>
          <CardExpiryElement style={{ flex: 1 }} />
          <CardCvcElement style={{ flex: 1 }} />
        </View>
      </CardFields>
    </Payments>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const payments = window.WhopElements().payments.create({ /* options */ });
  const cardFields = payments.create('cardFields', { /* options */ });
  cardFields.create('cardNumber').mount('#payments-cardFields-cardNumber');
  cardFields.create('cardExpiry').mount('#payments-cardFields-cardExpiry');
  cardFields.create('cardCvc').mount('#payments-cardFields-cardCvc');
  payments.create('branding').mount('#payments-branding');
</script>
```

```swift Swift theme={null}
import Elements
import SwiftUI

// .whopElements(environment:) runs once at the app root. See Getting started.
struct CheckoutScreen: View {
    @State private var card = WhopCardState(isComplete: false, brand: nil)

    var body: some View {
        WhopPayments(accountID: "biz_xxxx", charge: .plan(id: "plan_xxxx")) { payments in
            ScrollView {
                VStack(alignment: .leading, spacing: 20) {
                WhopCardFields(state: $card) {
                    WhopCardNumberElement()
                    HStack(alignment: .top, spacing: 8) {
                        WhopCardExpiryElement()
                        WhopCardCVCElement()
                    }
                }
                    WhopBrandingElement()
                }
                .padding()
            }
        }
    }
}
```

## Opties

Geef deze mee aan `payments.create('cardFields', { … })`, of als props op `<CardFields>` in React. Props die door de parent worden geïnjecteerd, verschijnen hier nooit.

**networks** `CardNetworkArt[]`

De door de verkoper geaccepteerde kaartnetwerken in weergavevolgorde — de `networks`-objecten van de kaartvermelding in de matrix, waarvan de door de API geleverde iconen de merkafbeelding van het nummerveld bepalen. Laat het weg om het samen met de sleutel op te halen.

**eigenschappen**

**brand** `string` *required*

Een van `"visa"`, `"mastercard"`, `"amex"`, `"discover"`, `"jcb"`, `"diners"`, `"unionpay"`, `"elo"` of `"maestro"`.

**icons** `object` *required*

**eigenschappen**

**square** `object` *required*

**eigenschappen**

**light** `object` *required*

**eigenschappen**

**svg** `string` *required*

**dark** `object` *required*

**eigenschappen**

**svg** `string` *required*

**layout** `"compact" | "stacked"`

`stacked` (standaard) vormt samengestelde velden als een nummerrij boven de vervaldatum en beveiligingscode. `compact` vormt één rij. Afzonderlijk gemounte velden negeren deze lay-out en worden weergegeven met volledige randen en afgeronde hoeken. Standaard `"stacked"`.

**publicKey** `string`

Geavanceerde publiceerbare sleutel van Basis Theory. Laat deze weg om de sleutel automatisch op te halen.

## Events

Geef callbacks mee in de create-opties of als React-props.

### `onChange`

Wordt geactiveerd wanneer de volledigheid verandert. `complete` wordt true nadat de koper alle drie de velden heeft ingevuld. Gebruik het om bevestigen mogelijk te maken. `brand` is het herkende kaartnetwerk zoals het veld het meldt; `network` is dezelfde herkenning in de netwerkterminologie van de API (komt overeen met de `networks` van de kaartvermelding in de matrix, `null` zolang onbekend). `last4` zijn de laatste vier cijfers van het nummer, `null` totdat het nummer ver genoeg is ingevuld. `funding` is het herkende financieringstype (`credit`, `debit` of `prepaid`), `null` totdat het nummer er een identificeert. `issuingCountry` is de tweeletterige code in kleine letters van het land waarin de kaart is uitgegeven, `null` totdat het nummer er een identificeert.

**payload** `object`

**eigenschappen**

**complete** `boolean` *required*

**brand** `string` *required*

**network** `string | null` *required*

Een van `"visa"`, `"mastercard"`, `"amex"`, `"discover"`, `"jcb"`, `"diners"`, `"unionpay"`, `"elo"`, `"maestro"` of `null`.

**last4** `string | null` *required*

**funding** `string | null` *required*

**issuingCountry** `string | null` *required*

## Methoden

Roep deze aan op de subhandle van `payments.create('cardFields', { … })`.

### `tokenize`

Geavanceerde methode die de drie velden tokeniseert zonder een bevestigingstoken aan te maken. Het verstuurt `tokenized` naar de payments-controller. Validatiefouten verschijnen bij het veld dat faalt, en de methode gooit een fout. Gebruik `payments.createConfirmationToken()` om een betaling te bevestigen.

**Parameters**

**input** `object` *required*

**eigenschappen**

**accountId** `string`

**Retourneert** `Promise<object>`

**token** `string` *required*

### `collect`

`payments.createConfirmationToken()` roept deze actie aan voor `cardFields`. Roep haar niet rechtstreeks aan. Ze tokeniseert de velden en retourneert de gegevens die worden gebruikt om het bevestigingstoken aan te maken.

**Parameters**

**input** `object` *required*

**eigenschappen**

**billingDetails** `object`

**eigenschappen**

**email** `string`

**name** `string`

**address** `object`

**eigenschappen**

**country** `string`

**line1** `string`

**city** `string`

**postal\_code** `string`

**Retourneert** `Promise<object>`

**paymentMethod** `object` *required*

**eigenschappen**

**type** `string` *required*

**category** `string` *required*

**card** `object` *required*

**eigenschappen**

**token** `string` *required*

**billingDetails** `object` *required*

**eigenschappen**

**email** `string` *required*

**name** `string`

**address** `object`

**eigenschappen**

**country** `string`

**line1** `string`

**city** `string`

**postal\_code** `string`

### `update`

Voegt nieuwe props en callbacks samen in de subcontroller.

**Parameters**

**options** `Partial\<CardFieldsSubOptions\>` *required*

### `destroy`

Verwijdert de subcontroller en zijn elementen en maakt daarna zijn exclusieve plek vrij. Een latere `create("cardFields")` begint opnieuw.

## Parameters

**publicKey** `String?`

Een geavanceerde publiceerbare sleutel. Laat je die weg, dan wordt de eigen sleutel van het account opgehaald.

**layout** `WhopCardElement.Layout`

Wordt alleen gelezen wanneer een samenstellende eenheid de velden zelf rangschikt. Afzonderlijk gemounte velden negeren het.

**state** `Binding\<WhopCardState\>?`

Leest de volledigheid en het herkende merk terug.

**content** `() -\> Content` *required*

Waar de drie veldweergaven komen. Al het andere hierin wordt normaal weergegeven.

## `WhopCardState`

Wat een selectie teruggeeft:

* `isComplete: Bool`: alle drie de velden zijn geldig
* `brand: String?`: het herkende netwerk

## Statussen

Elk veld wordt direct weergegeven en valideert terwijl de koper typt. `state.isComplete` wordt true wanneer alle drie geldig zijn, waar je ze ook plaatst.

## Goed om te weten

* De drie veldweergaven werken alleen binnen een `WhopCardFields`-builder: ze lezen de eenheid die die aanmaakt. Elders gemount geven ze niets weer.
* Mount alle drie. Een eenheid waarin er een ontbreekt, wordt nooit volledig, dus de bevestigingsknop wordt nooit ingeschakeld.

## Installatie

```swift theme={null}
dependencies: [
    .package(url: "https://github.com/whopio/elements-swift.git", from: "0.1.0")
]
```

> [!NOTE]
>
> Mount het binnen een `WhopPayments(accountID:charge:)`-scope, die de controller aanmaakt en aan de inhoud doorgeeft. `payments.buyer` is de ingelogde koper zodra een inlog via e-mail er een heeft bevestigd. `WhopBrandingElement` moet ook op het scherm staan, omdat Whop merchant of record is bij deze verkopen en `createConfirmationToken` zonder dit element weigert. Style met `.whopElementsAppearance(_:)`. De module is `Elements`, niet `WhopElements` van de wallet-SDK. Zie [Aan de slag](https://docs.whop.com/nl/elements/latest/getting-started.md) en [Appearance](https://docs.whop.com/nl/elements/latest/appearance.md).

## Props

**children** `ReactNode` *required*

Je lay-out, met de drie veldelementen ergens daarbinnen.

**publicKey** `string`

Een geavanceerde publiceerbare sleutel voor de tokenizer. Laat je die weg, dan haalt de SDK de sleutel van het account zelf op.

**layout** `'stacked' | 'compact'`

Vormt velden die samen zijn samengesteld. Afzonderlijk gemounte velden negeren het en worden weergegeven met volledige randen. Standaard `stacked`.

**onChange** `(payload: CardFieldsChangePayload) =\> void`

Wordt bij elke wijziging geactiveerd met de gecombineerde status van de gemounte velden.

## `CardFieldsChangePayload`

Wat `onChange` teruggeeft:

* `complete: boolean`: elk gemount veld is ingevuld en geldig
* `errors: Record<string, string>`: meldingen per veld, met de sleutels `cardNumber`, `cardExpiry`, `cardCvc`

## Statussen

De children worden weergegeven zodra de publiceerbare sleutel is opgehaald. `onChange` meldt de gecombineerde status van elk gemount veld, zodat één handler de hele kaart dekt.

## Goed om te weten

* Kaartnummers gaan nooit door je code. De velden zijn PCI-geïsoleerde native invoervelden en de SDK geeft Whop een token, zodat je app buiten de PCI-scope blijft.
* Elk veld moet binnen dezelfde `CardFields` staan. Ze delen één tokenisatie, dus een veld dat daarbuiten is gemount, verzamelt niets.
* `CardFields` registreert het verzameloppervlak, zodat `createConfirmationToken` de kaart tokeniseert zonder extra koppeling.
* Het ophalen van de publiceerbare sleutel gebeurt automatisch. Geef `publicKey` alleen mee als je er al een hebt.

> [!NOTE]
>
> Wikkel je app eenmaal in `<WhopElements getToken={…}>` en mount daarna `<Payments>` rond de elementen. Zie [Aan de slag](https://docs.whop.com/nl/elements/latest/getting-started.md) en [Appearance](https://docs.whop.com/nl/elements/latest/appearance.md).

## Elementen

De elementen die deze subcontroller mount. Elk heeft een eigen pagina:

> [card] [CardNumberElement](https://docs.whop.com/nl/elements/latest/payments/cardFields-cardNumber.md)
>
> PCI-geïsoleerd gehost veld voor het kaartnummer. Kaartnummers bereiken de hostpagina nooit.

> [card] [CardExpiryElement](https://docs.whop.com/nl/elements/latest/payments/cardFields-cardExpiry.md)
>
> PCI-geïsoleerd gehost veld voor de vervaldatum van de kaart.

> [card] [CardCvcElement](https://docs.whop.com/nl/elements/latest/payments/cardFields-cardCvc.md)
>
> PCI-geïsoleerd gehost veld voor de beveiligingscode van de kaart.


## Related topics

- [CardCvcElement](https://docs.whop.com/nl/elements/latest/payments/cardFields-cardCvc.md)
- [CardExpiryElement](https://docs.whop.com/nl/elements/latest/payments/cardFields-cardExpiry.md)
- [CardNumberElement](https://docs.whop.com/nl/elements/latest/payments/cardFields-cardNumber.md)
