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

> Tre separat monterbare, PCI-isolerede kortfelter til brugerdefinerede layouts: nummer, udløbsdato og sikkerhedskode. Opret med `payments.create("cardFields")`, placér hvert felt, aktivér din betalingsknap ud fra `onChange`, og bekræft med `payments.createConfirmationToken()`. Kortnumre forbliver i hostede felter.

> [!NOTE]
>
> Denne side dokumenterer `@whop/elements@1.10.0` og `@whop/elements-react@1.10.0`.

*Siden `v1.0.0`.*

Monteres inde i [`Payments`](https://docs.whop.com/da/elements/latest/payments/overview). Opret den for at få et handle, og montér derefter dens elementer på det handle. Kald `destroy()` for at fjerne sub-controlleren og frigøre dens plads. Opret den igen for at få et nyt handle.

> [!NOTE]
>
> **Eksklusiv.**`CardFields` er et alternativ til `PaymentElement` eller `CardElement` i dette Payments-handle. Montér ét ad gangen. Ødelæg det, før du monterer et andet.

## Forhåndsvisning

En live, interaktiv demo af denne sub-controllers standardopsætning med eksempeldata:

Monteres inde i et `WhopPayments`-scope. De samme tre hostede inputs som [`WhopCardElement`](https://docs.whop.com/da/elements/latest/payments/card#swift), placeret enkeltvis inde i dens content builder, så dit eget layout bestemmer, hvor hvert enkelt placeres.

Provideren til enkeltvis placerede kortfelter. Pak den del af din formular ind, der indeholder dem, og placér derefter `CardNumberElement`, `CardExpiryElement` og `CardCvcElement`, hvor dit layout ønsker dem.

## Forhåndsvisning

Kørende i React Native-eksempelappen:

[CardFields kørende på Android i React Native-eksempelappen](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()
            }
        }
    }
}
```

## Indstillinger

Angiv disse til `payments.create('cardFields', { … })` eller som props på `<CardFields>` i React. Props, der injiceres af forælderen, vises aldrig her.

**networks** `CardNetworkArt[]`

Sælgerens accepterede kortnetværk i visningsrækkefølge — matrixens kortposts `networks`-objekter, hvis ikoner leveret af API'et styrer nummerfeltets kortmærkegrafik. Udelad den for at hente dem sammen med nøglen.

**egenskaber**

**brand** `string` *required*

En af `"visa"`, `"mastercard"`, `"amex"`, `"discover"`, `"jcb"`, `"diners"`, `"unionpay"`, `"elo"` eller `"maestro"`.

**icons** `object` *required*

**egenskaber**

**square** `object` *required*

**egenskaber**

**light** `object` *required*

**egenskaber**

**svg** `string` *required*

**dark** `object` *required*

**egenskaber**

**svg** `string` *required*

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

`stacked` (standard) former sammensatte felter som en nummerrække over udløbsdato og sikkerhedskode. `compact` former én række. Separat monterede felter ignorerer dette layout og renderes med fulde kanter og afrundede hjørner. Standard er `"stacked"`.

**publicKey** `string`

Avanceret Basis Theory publishable key. Udelad den for at hente nøglen automatisk.

## Events

Angiv callbacks i create-indstillingerne eller som React-props.

### `onChange`

Udløses, når fuldstændigheden ændres. `complete` bliver true, når køberen har udfyldt alle tre felter. Brug det til at aktivere bekræftelse. `brand` er det registrerede kortnetværk, som feltet rapporterer det; `network` er den samme registrering i API'ets netværksordforråd (matcher matrixens kortposts `networks`, `null` så længe det er ukendt). `last4` er nummerets sidste fire cifre, `null` indtil nummeret er tastet langt nok. `funding` er den registrerede finansieringstype (`credit`, `debit` eller `prepaid`), `null` indtil nummeret identificerer en. `issuingCountry` er den to-bogstavs landekode med små bogstaver for det land, kortet er udstedt i, `null` indtil nummeret identificerer et.

**payload** `object`

**egenskaber**

**complete** `boolean` *required*

**brand** `string` *required*

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

En af `"visa"`, `"mastercard"`, `"amex"`, `"discover"`, `"jcb"`, `"diners"`, `"unionpay"`, `"elo"`, `"maestro"` eller `null`.

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

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

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

## Metoder

Kald disse på sub-handlet fra `payments.create('cardFields', { … })`.

### `tokenize`

Avanceret metode, der tokeniserer de tre felter uden at oprette et bekræftelsestoken. Den udsender `tokenized` til payments-controlleren. Valideringsfejl vises på det fejlende felt, og metoden kaster en fejl. Brug `payments.createConfirmationToken()` til at bekræfte en betaling.

**Parametre**

**input** `object` *required*

**egenskaber**

**accountId** `string`

**Returnerer** `Promise<object>`

**token** `string` *required*

### `collect`

`payments.createConfirmationToken()` kalder denne handling for `cardFields`. Kald den ikke direkte. Den tokeniserer felterne og returnerer de data, der bruges til at oprette bekræftelsestokenet.

**Parametre**

**input** `object` *required*

**egenskaber**

**billingDetails** `object`

**egenskaber**

**email** `string`

**name** `string`

**address** `object`

**egenskaber**

**country** `string`

**line1** `string`

**city** `string`

**postal\_code** `string`

**Returnerer** `Promise<object>`

**paymentMethod** `object` *required*

**egenskaber**

**type** `string` *required*

**category** `string` *required*

**card** `object` *required*

**egenskaber**

**token** `string` *required*

**billingDetails** `object` *required*

**egenskaber**

**email** `string` *required*

**name** `string`

**address** `object`

**egenskaber**

**country** `string`

**line1** `string`

**city** `string`

**postal\_code** `string`

### `update`

Fletter nye props og callbacks ind i sub-controlleren.

**Parametre**

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

### `destroy`

Ødelægger sub-controlleren og dens elementer og frigør derefter dens eksklusive plads. Et senere `create("cardFields")` starter forfra.

## Parametre

**publicKey** `String?`

En avanceret publishable key. Udelad den, så hentes kontoens egen.

**layout** `WhopCardElement.Layout`

Læses kun, når en sammensættende enhed selv arrangerer felterne. Separat monterede felter ignorerer den.

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

Læser fuldstændigheden og det registrerede kortmærke ud igen.

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

Hvor de tre feltvisninger placeres. Alt andet herinde renderes normalt.

## `WhopCardState`

Det, et valg returnerer:

* `isComplete: Bool`: alle tre felter er gyldige
* `brand: String?`: det registrerede netværk

## Tilstande

Hvert felt renderes med det samme og validerer, mens køberen skriver. `state.isComplete` bliver true, når alle tre er gyldige, uanset hvor du placerer dem.

## Godt at vide

* De tre feltvisninger virker kun inde i en `WhopCardFields`-builder: de læser den enhed, den opretter. Monteret andre steder renderer de intet.
* Montér alle tre. En enhed, der mangler ét, bliver aldrig fuldstændig, så bekræftelsesknappen bliver aldrig aktiveret.

## Installation

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

> [!NOTE]
>
> Montér det inde i et `WhopPayments(accountID:charge:)`-scope, som opretter controlleren og giver den videre til sit indhold. `payments.buyer` er den indloggede køber, når en e-mail-login har bekræftet en. `WhopBrandingElement` skal også være på skærmen, fordi Whop er merchant of record på disse salg, og `createConfirmationToken` afviser uden det. Style med `.whopElementsAppearance(_:)`. Modulet er `Elements`, ikke wallet-SDK'ets `WhopElements`. Se [Kom godt i gang](https://docs.whop.com/da/elements/latest/getting-started.md) og [Appearance](https://docs.whop.com/da/elements/latest/appearance.md).

## Props

**children** `ReactNode` *required*

Dit layout med de tre feltelementer et sted inde i det.

**publicKey** `string`

En avanceret publishable key til tokenizeren. Udelad den, så henter SDK'et selv kontoens nøgle.

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

Former felter, der er sammensat. Separat monterede felter ignorerer den og renderes med fulde kanter. Standard er `stacked`.

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

Udløses ved hver redigering med den samlede tilstand for de monterede felter.

## `CardFieldsChangePayload`

Det, `onChange` returnerer:

* `complete: boolean`: alle monterede felter er udfyldt og gyldige
* `errors: Record<string, string>`: meddelelser pr. felt med nøglerne `cardNumber`, `cardExpiry`, `cardCvc`

## Tilstande

Dens children renderes, så snart den publishable key er resolveret. `onChange` rapporterer den samlede tilstand for alle monterede felter, så én handler dækker hele kortet.

## Godt at vide

* Kortnumre passerer aldrig gennem din kode. Felterne er PCI-isolerede native inputs, og SDK'et giver Whop et token, så din app holdes uden for PCI-scope.
* Alle felter skal være inde i den samme `CardFields`. De deler én tokenisering, så et felt monteret uden for den indsamler intet.
* `CardFields` registrerer indsamlingsfladen, så `createConfirmationToken` tokeniserer kortet uden ekstra opsætning.
* Den publishable key hentes automatisk. Angiv kun `publicKey`, hvis du allerede har en.

> [!NOTE]
>
> Pak din app ind i `<WhopElements getToken={…}>` én gang, og montér derefter `<Payments>` omkring elementerne. Se [Kom godt i gang](https://docs.whop.com/da/elements/latest/getting-started.md) og [Appearance](https://docs.whop.com/da/elements/latest/appearance.md).

## Elementer

De elementer, som denne sub-controller monterer. Hvert har sin egen side:

> [card] [CardNumberElement](https://docs.whop.com/da/elements/latest/payments/cardFields-cardNumber.md)
>
> PCI-isoleret hostet felt til kortnummer. Kortnumre når aldrig værtssiden.

> [card] [CardExpiryElement](https://docs.whop.com/da/elements/latest/payments/cardFields-cardExpiry.md)
>
> PCI-isoleret hostet felt til kortets udløbsdato.

> [card] [CardCvcElement](https://docs.whop.com/da/elements/latest/payments/cardFields-cardCvc.md)
>
> PCI-isoleret hostet felt til kortets sikkerhedskode.
