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

# PaymentElement

> Toont de beschikbare betaalmethoden en verzamelt de vereiste velden en vermeldingen van de geselecteerde methode. Gebruik `change` om je betaalknop in te schakelen. Roep in de activeringshandler ervan `payments.createConfirmationToken()` aan. Bevestig het token server-side en geef daarna een eventuele openstaande stap door aan `payments.handleNextAction(…)`. Gebruik `addressChange` voor updates die van het adres afhangen.

> [!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). Geef props en callbacks mee via de create-opties of als React-props. Bewaar de aangemaakte handle, of de React-`ref`, om `select()` aan te roepen.

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

> [!NOTE]
>
> **Wacht op `BrandingElement`.** Dit element blijft in de laadstatus totdat `BrandingElement` in dezelfde Payments-handle is gemount.

Wordt gemount binnen een `WhopPayments`-scope. Geeft de methodetegels weer die de afschrijving aanbiedt, en daarna wat de geselecteerde methode verzamelt: de kaartvelden, de velden die ze declareert of de Apple Pay-knop.

Mount binnen `<Payments>`, dat de afschrijving en het bevestigingstoken beheert. `<Payments>` zelf wordt gemount binnen `<WhopElements>`. Het geeft de methodetegels voor de afschrijving weer en verzamelt wat de geselecteerde methode declareert, zodat een kaart, een walletsheet en een bankdoorverwijzing allemaal dezelfde ene regel zijn.

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Payments /* options */>
        <PaymentElement onChange={(e) => console.log(e)} onAddressChange={(e) => console.log(e)} />
        <BrandingElement />
      </Payments>
    </WhopElements>
  );
}
```

```tsx React Native theme={null}
import { useRef, useState } from 'react';
import { Button, ScrollView } from 'react-native';
import { EmailElement, PaymentElement, Payments, type PaymentsHandle } from '@whop/elements-react-native';

export function PaymentStep() {
  const payments = useRef<PaymentsHandle | null>(null);
  const [ready, setReady] = useState(false);

  return (
    <Payments
      ref={payments}
      accountId="biz_xxxxxxxx"
      plan="plan_xxxxxxxx"
      returnUrl="https://example.com/checkout/return"
    >
      <ScrollView>
        <EmailElement />
        <PaymentElement onChange={(p) => setReady(p.complete)} />
      </ScrollView>
      <Button
        title="Pay"
        disabled={!ready}
        onPress={async () => {
          const token = await payments.current!.createConfirmationToken();
          console.log(token.confirmationToken, token.type);
        }}
      />
    </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 */ });
  payments.create('payment', {
    onChange: (e) => console.log(e),
    onAddressChange: (e) => console.log(e)
  }).mount('#payments-payment');
  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 selection = WhopPaymentSelection(isComplete: false, type: nil, displayName: nil, category: nil)

    var body: some View {
        WhopPayments(accountID: "biz_xxxx", charge: .plan(id: "plan_xxxx")) { payments in
            ScrollView {
                VStack(alignment: .leading, spacing: 20) {
                WhopPaymentElement(selection: $selection)
                    WhopBrandingElement()
                }
                .padding()
            }
        }
    }
}
```

Voorbeeldgegevens. [Open de Playground](https://docs.whop.com/nl/elements/latest/payments/overview#playground).

[PaymentElement draaiend op Android, in de React Native-voorbeeldapp](https://app.revyl.ai/embed/c05028fb-0d33-4f36-b6f9-5339a4b9a054?controls=0)

## Props

**order** `string[]`

Bepaalt de weergavevolgorde in beide lay-outs. Vermelde typen verschijnen eerst, in volgorde. Niet-vermelde typen behouden hun relatieve volgorde. Heeft geen invloed op de beschikbaarheid. Standaard `[]`.

**wallets** `object`

Bepaalt welke wallets het element aanbiedt. Elke sleutel is standaard `'auto'`, wat de wallet aanbiedt overal waar het account, het apparaat van de koper en de afschrijving die ondersteunen. `'never'` verwijdert die wallet uit de methodelijst. Gebruik het wanneer je pagina eigen knoppen voor Apple Pay, Google Pay of PayPal tekent met `paymentRequest`, zodat kopers elke wallet maar één keer zien. `payPal: 'never'` verwijdert de PayPal-methode. Opgeslagen betaalmethoden worden niet beïnvloed. Standaard `{}`. Sinds `v1.8.0`.

**eigenschappen**

**applePay** `"never" | "auto"`

**googlePay** `"never" | "auto"`

**payPal** `"never" | "auto"`

**fields** `object`

Bepaalt het verzamelen van factuurgegevens. `billingDetails: 'minimal'` (standaard) volgt de matrix van elke methode. Methoden verzamelen standaard de naam en het volledige landformaat. Een overschrijving kan alleen het gedeclareerde minimum of niets verzamelen. Voor kaarten is het minimum de naam op de kaart, het land en de postcode. `'full'` vereist de naam en het volledige landformaat voor elke nieuwe methode. `'never'` verbergt het blok. `address: 'minimal'` verzamelt alleen het gedeclareerde minimum van elke methode plus een land waar dat minimum er geen bevat (en ook de postcode wanneer `billingDetails: 'full'` aangeeft dat er belasting over de checkout wordt geheven), behalve voor wallets, crypto, bankincasso's, bankoverschrijvingen, card-present en in-app-aankopen, die helemaal geen adres verzamelen, en behalve voor een methode waarvan de provider het volledige factuuradres vereist (`requires_full_billing_address`), waarvan de tegel dezelfde regels volgt als een checkout zonder deze markering; verder heeft het voorrang op `billingDetails: 'full'`; gebruik het wanneer de verkoper geen volledig factuuradres verzamelt. `phone: 'never'` verbergt alleen het telefoonveld voor facturering wanneer je formulier dat al verzamelt; geef `billingDetails.phone` mee aan `createConfirmationToken` voor methoden die het vereisen. Geef in plaats daarvan het adres mee aan `createConfirmationToken`. De landkiezer bevat alleen landen die door de methode en de betalingsvaluta worden ondersteund. Als er een termijnplan is geselecteerd, wordt deze beperkt tot de landen die het plan bedient — het factuurland is het transactieland waaronder de afschrijving wordt verwerkt. De kiezer wordt vergrendeld wanneer er maar één beschikbaar is. Standaard `{"billingDetails":"minimal"}`.

**eigenschappen**

**billingDetails** `"minimal" | "full" | "never"`

**address** `"minimal" | "auto"`

**phone** `"never" | "auto"`

**defaultValues** `object`

Vult de factuurgegevens vooraf in wanneer het factuurblok van elke methode voor het eerst wordt weergegeven. De koper kan elk vooraf ingevuld veld bewerken. `address.country` is een ISO 3166-1 alpha-2-code en geldt alleen wanneer de geselecteerde methode die accepteert. `phone` vult het telefoonveld voor facturering in voor methoden die er een verzamelen, in E.164-formaat zoals `+14155552671`; een nummer buiten de ondersteunde telefoonlanden van de methode wordt genegeerd. Alleen velden die het blok weergeeft, worden vooraf ingevuld en verzonden. Geef al het andere mee aan `createConfirmationToken` in `billingDetails`. Sinds `v1.1.0`.

**eigenschappen**

**billingDetails** `object`

**eigenschappen**

**name** `string`

**phone** `string`

**address** `object`

**eigenschappen**

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**layout** `"accordion" | "horizontal"`

Lay-out van de kiezer. `accordion` (standaard) stapelt methoden en klapt details inline uit. `horizontal` toont niet-scrollende tegels van gelijke breedte met de geselecteerde details eronder. Na vier methoden opent een tegel More een native kiezer. De daar gekozen methode bezet de laatste tegel tot de volgende selectie. Selectie en bevestiging werken hetzelfde. Standaard `"accordion"`.

**separated** `boolean`

Alleen `accordion`. Voegt ruimte en een aparte kaartstijl toe tussen methoden. Wordt genegeerd wanneer `layout` `horizontal` is. Standaard `false`.

**autoSelect** `boolean`

Of de eerste aangeboden methode na het ophalen wordt geselecteerd. De standaardwaarde `true` respecteert `order` en zendt `selected` en `change` uit zoals bij een interactie van de koper. Het wordt eenmaal uitgevoerd vóór interactie van de koper en doet niets wanneer er geen methode wordt aangeboden. Stel in op `false` om zonder selectie te mounten. Los daarvan valt de selectie terug op de eerste aangeboden methode als een update de geselecteerde methode verwijdert. Een element zonder selectie blijft zonder selectie. Standaard `true`.

## Events

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

### `onChange`

Wordt geactiveerd wanneer de selectie verandert. `complete: true` betekent dat de koper een methode heeft geselecteerd en de kaartvelden of vereiste invoer ervan heeft ingevuld. Gebruik het om bevestiging in te schakelen. `paymentMethod` is de geselecteerde betaalmethode, opgeslagen of nieuw, of `null` zolang er niets is geselecteerd: `displayName` en `icons` benoemen de keuze zoals het element die toont (met `balance.imageUrl`, de afbeelding van de eigenaar van een saldo), `card` bevat het netwerk, de laatste vier cijfers en het financieringstype van een kaart, `requiresBillingPhone` geeft aan of de methode een telefoonnummer in de factuurgegevens nodig heeft, en `countries` vermeldt vanuit welke landen de methode kan betalen in de valuta van de afschrijving. `type`, `requiresBillingPhone` en `method` op het hoogste niveau zijn verouderd: lees ze uit `paymentMethod`. `supportsBuyerFee` op het hoogste niveau is ook verouderd, zonder vervanging: Whop bepaalt de prijs van zijn servicekosten voor kopers zelf.

**payload** `PaymentElementChangeEvent`

**eigenschappen**

**complete** `boolean` *required*

Of de koper een methode heeft geselecteerd en de kaartvelden of vereiste invoer ervan heeft ingevuld. Gebruik het om bevestiging in te schakelen.

**paymentMethod** `PaymentElementPaymentMethod | null` *required*

De geselecteerde betaalmethode, of `null` zolang er niets is geselecteerd.

**eigenschappen**

**id** `string | null` *required*

De opgeslagen betaalmethode die de koper heeft gekozen, of `null` voor een methode die de koper nu invoert of een saldo.

**type** `string` *required*

Het type betaalmethode: `card`, `klarna`, `apple_pay`, `balance`, enzovoort.

**category** `string` *required*

De familie waartoe het type behoort, zoals `card`, `wallet`, `bnpl` of `balance`.

**displayName** `string` *required*

Hoe de keuze heet: het eigen label van een opgeslagen methode ("Visa •••• 4242", "Cash App \$tag"), de naam van een saldo ("Acme", "Personal Balance"), het netwerk en de laatste vier cijfers van een kaart terwijl de koper die typt, of anders de eigen naam van de methode ("Klarna").

**icons** `PaymentMethodIcons`

De iconen van de keuze: de eigen iconen van een opgeslagen methode, de netwerkafbeelding van een getypte kaart, of anders de iconen van de methode. Altijd een iconenset, met SVG- en PNG-versies.

**eigenschappen**

**square** `PaymentMethodIconVariants | null`

**eigenschappen**

**light** `object` *required*

**eigenschappen**

**svg** `string` *required*

**dark** `object` *required*

**eigenschappen**

**svg** `string` *required*

**card** `PaymentMethodIconVariants | null`

**eigenschappen**

**light** `object` *required*

**eigenschappen**

**svg** `string` *required*

**dark** `object` *required*

**eigenschappen**

**svg** `string` *required*

**balance** `object`

Wat er naast het type bekend is over een gekozen saldo: `imageUrl` is de afbeelding van de eigenaar van het saldo, één URL van een rasterafbeelding in plaats van een iconenset, om te tonen in plaats van `icons`. Ontbreekt bij andere methoden en bij een saldo waarvan de eigenaar geen afbeelding heeft.

**eigenschappen**

**imageUrl** `string`

**card** `object`

Wat er bekend is over een gekozen kaart: de gegevens van een opgeslagen kaart, of die van een getypte kaart terwijl de koper typt. Ontbreekt bij andere methoden.

**eigenschappen**

**network** `string`

**last4** `string`

**funding** `string`

**requiresBillingPhone** `boolean` *required*

Of de methode een telefoonnummer in de factuurgegevens nodig heeft, ook wanneer `fields.phone` het eigen telefoonveld van het element uitschakelt.

**countries** `string[]` *required*

De tweeletterige landcodes in kleine letters van de landen vanuit welke de methode kan betalen in de valuta van de afschrijving.

**type** `string` *deprecated*

> [!WARNING]
>
> Verouderd. Gebruik `paymentMethod.type`.

**supportsBuyerFee** `boolean` *deprecated*

> [!WARNING]
>
> Verouderd. Whop bepaalt de prijs van zijn servicekosten voor kopers zelf, dus een pagina heeft er niets aan. Wordt verwijderd in de volgende major-versie.

**requiresBillingPhone** `boolean` *deprecated*

> [!WARNING]
>
> Verouderd. Gebruik `paymentMethod.requiresBillingPhone`.

**method** `object` *deprecated*

> [!WARNING]
>
> Verouderd. Gebruik `paymentMethod`. Ontbreekt wanneer de koper een opgeslagen methode kiest.

**eigenschappen**

**type** `string` *required*

**category** `string` *required*

**template** `string` *required*

**display\_name** `string` *required*

**countries** `object[]` *required*

**eigenschappen**

**country** `string` *required*

**min\_amount** `number | null` *required*

**max\_amount** `number | null` *required*

**min\_amount** `number | null` *required*

**max\_amount** `number | null` *required*

### `onAddressChange`

Wordt ongeveer 300 ms nadat het interne factuuradres verandert geactiveerd. Gebruik het voor belasting, verzending of andere updates die van het adres afhangen. `country` is een ISO 3166-1 alpha-2-code. De payload laat andere adressleutels weg wanneer die leeg zijn of voor dat land niet worden gebruikt. `complete: true` betekent dat het factuurblok geldig en volledig is. Dit event wordt alleen geactiveerd zolang het betaalelement het verzamelen van het adres beheert. Gebruik bij `fields.billingDetails: 'never'` je eigen adresbron. Gebruik bij een gemount `AddressElement` het `change`-event daarvan.

**payload** `object`

**eigenschappen**

**complete** `boolean` *required*

**address** `object` *required*

**eigenschappen**

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string` *required*

### `onLoaderStart`

Wordt uitgevoerd nadat het laadskelet voor het eerst is weergegeven en vóór `onReady`.

### `onReady`

Wordt uitgevoerd na de eerste volledige weergave van het element.

### `onError`

Wordt uitgevoerd wanneer het element niet kan laden of crasht. De fallback blijft zichtbaar. Gebruik `code` voor programmatische afhandeling. `sourceKey` identificeert een mislukte host-state-bron.

**e** `object`

**eigenschappen**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Methoden

Roep deze aan op de handle die `create` retourneert, of via een React-`ref`.

### `select`

Selecteer een methode via hetzelfde pad als een interactie van de koper. `select('cashapp')` klapt bijvoorbeeld de tegel uit en zendt `selected` en `change` uit. Kaarten blijven `complete: false` totdat hun velden volledig zijn. Onbekende, niet-beschikbare of door het bedrag uitgesloten methoden worden geweigerd met code `METHOD_NOT_OFFERED`. `select(null)` wist de selectie en zendt `change` uit met `complete: false`. Gebruik het met `autoSelect={false}` voor volledige externe controle.

**Parameters**

**input** `string | null` *required*

**Retourneert** `Promise<void>`

### `mount`

Mount het element in `target` en begint met laden. React-componenten mounten zichzelf.

**Parameters**

**target** `string | HTMLElement` *required*

### `destroy`

Verwijdert het element en geeft het frame en de abonnementen vrij. Je kunt het meerdere keren aanroepen. React verwijdert het element automatisch.

### `update`

Voegt nieuwe props samen in het gemounte element. Wijzig in React in plaats daarvan de componentprops.

**Parameters**

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

## Styling

Style deze onderdelen via `appearance.classes`. Gebruik camelCase of kebab-case voor eigenschapsnamen en vermeld eenheden. Stylesheets van de pagina kunnen het frame van het element niet bereiken. Het framework valideert elke declaratie voordat die wordt geïnjecteerd.

| Klasse | Doel |
| - | - |
| `.whop-Address` | De root van het adresformulier |
| `.whop-AddressErrorSummary` | De samenvattingsregel die wordt getoond wanneer validatie ontbrekende of ongeldige velden aan het licht brengt |
| `.whop-AddressField` | Eén veldcel in het adresformulier |
| `.whop-AddressFieldError` | De foutregel voor een adresveld: eronder in de volledige lay-out, onder de groep voor een composermelding in de compacte lay-out |
| `.whop-AddressFieldInput` | Een tekstinvoer in het adresformulier |
| `.whop-AddressFieldInputInvalid` | Toegevoegd aan een adresinvoer zolang die de validatie niet doorstaat |
| `.whop-AddressFieldInvalid` | Toegevoegd aan een compacte veldcel zolang die de validatie niet doorstaat |
| `.whop-AddressFieldLabel` | Label van een adresveld: boven het veld, of erin bij zwevende labels |
| `.whop-AddressFieldSelect` | Een keuzelijst (land, staat, organisatietype) in het adresformulier |
| `.whop-AddressGroup` | De omrande groep die elk veld bevat in de compacte lay-out |
| `.whop-AddressLine2Toggle` | Schakelaar voor ingeklapte adresregel 2 |
| `.whop-AddressManualEntry` | De tekstknop "Enter address manually" onder het ingeklapte formulier — klapt het volledige landformaat uit |
| `.whop-AddressSearchButton` | De zoekknop aan het einde van het straatveld op een telefoon |
| `.whop-AddressSuggestion` | Eén suggestierij in de autocomplete-overlay |
| `.whop-AddressSuggestionActive` | Toegevoegd aan de suggestierij die actief is via toetsenbord of aanwijzer |
| `.whop-AddressSuggestionManual` | De rij "Enter address manually" die de suggestielijst afsluit |
| `.whop-AddressSuggestions` | De overlay met autocomplete-suggesties, verankerd aan het veld voor adresregel 1 |
| `.whop-AddressSuggestionsEmpty` | De bescheiden regel die wordt getoond wanneer de zoekopdracht zonder adresovereenkomsten is afgerond |
| `.whop-CardField` | Veld voor kaartnummer, vervaldatum of beveiligingscode |
| `.whop-CardFieldError` | Validatiemelding van de kaart |
| `.whop-CardFieldGroup` | De gegroepeerde kaartvelden — nummer bovenaan, vervaldatum en beveiligingscode eronder |
| `.whop-CardFieldInput` | Omrande PCI-invoercontainer |
| `.whop-CardFieldInputFocused` | PCI-invoercontainer met focus |
| `.whop-CardFieldInputInvalid` | Ongeldige of onvolledige PCI-invoercontainer |
| `.whop-CardLabel` | Label voor kaartgegevens |
| `.whop-Payment` | De root van het betaalelement |
| `.whop-PaymentBalance` | Eén wallet in de saldotegel |
| `.whop-PaymentBalanceHint` | Het beschikbare bedrag van de wallet in de valuta van de afschrijving |
| `.whop-PaymentBalanceList` | De scrollbare lijst met wallets van de koper in de saldotegel |
| `.whop-PaymentBalanceMore` | De sentinelrij die meer saldi laadt wanneer die in beeld scrolt |
| `.whop-PaymentBalanceRow` | De klikbare saldorij |
| `.whop-PaymentBalanceRowSelected` | Geselecteerde saldorij |
| `.whop-PaymentBalanceRowUnavailable` | Een wallet die nu niet kan betalen — geblokkeerd of leeg — grijs en uitgeschakeld |
| `.whop-PaymentBillingBlock` | Het interne factuuradresblok van het betaalelement |
| `.whop-PaymentCardFields` | Het inline paneel met kaartvelden |
| `.whop-PaymentCompactBalance` | Het geselecteerde saldo bij een compacte directe checkout |
| `.whop-PaymentCompactSavedMethod` | De geselecteerde opgeslagen methode bij een compacte directe checkout |
| `.whop-PaymentCurrencyFallback` | De overschakeling naar de fallbackvaluta wanneer er niets wordt aangeboden |
| `.whop-PaymentDetailIcon` | Het sjabloonicoon naast de uitleg in het detailgebied |
| `.whop-PaymentDetailRegion` | Het uitgeklapte detailgebied voor een geselecteerde methode — eerst de verzameloppervlakken (inline kaartvelden, gedeclareerde invoer), daarna de uitleg en vermeldingsregels als onderste blok |
| `.whop-PaymentDetailSubtext` | De toestemmingstekst onder de uitleg bij walletmethoden |
| `.whop-PaymentDetailText` | De uitlegregel van het detailgebied |
| `.whop-PaymentError` | Foutpaneel voor niet-beschikbare betaalmethoden |
| `.whop-PaymentFieldError` | De melding Invalid onder een gedeclareerd invoerveld |
| `.whop-PaymentFieldInput` | Een gedeclareerd methode-invoerveld in het detailgebied |
| `.whop-PaymentFieldInputInvalid` | Toegevoegd aan een gedeclareerd invoerveld zolang de waarde niet aan het gedeclareerde formaat voldoet |
| `.whop-PaymentFieldLabel` | Label van een gedeclareerd betaalveld |
| `.whop-PaymentInstallmentDetail` | Het bedrag per termijn in een rij met een termijnoptie |
| `.whop-PaymentInstallmentLabel` | Het label van een rij met een termijnoptie |
| `.whop-PaymentInstallmentList` | De optielijst van de termijnkiezer |
| `.whop-PaymentInstallmentRadio` | De radio-indicator op een rij met een termijnoptie |
| `.whop-PaymentInstallmentRow` | Eén rij met een termijnoptie |
| `.whop-PaymentInstallmentRowSelected` | De geselecteerde rij met een termijnoptie |
| `.whop-PaymentInstallments` | De termijnkiezer van de betaalmethode |
| `.whop-PaymentInstallmentsLabel` | De kop van de termijnkiezer |
| `.whop-PaymentInstallmentsNotice` | De disclaimer over kosten van de uitgever onder een geselecteerd niveau zonder gedeclareerde kosten |
| `.whop-PaymentMandateLink` | De link naar de machtigingsvoorwaarden binnen de machtigingsmelding |
| `.whop-PaymentMandateNotice` | De melding voor machtigingsautorisatie bij methoden waarvan de matrixconfiguratie een machtiging declareert |
| `.whop-PaymentMethod` | Eén betaalmethode — de rij plus het uitklapbare detailgebied |
| `.whop-PaymentMethodDetail` | Het uitklapbare gebied dat de details van de geselecteerde methode toont — inline kaartvelden, uitleg of gedeclareerde invoer |
| `.whop-PaymentMethodIcon` | Het methode-icoon op een rij |
| `.whop-PaymentMethodLabel` | De weergavenaam van de methode op een rij |
| `.whop-PaymentMethodMoreSelect` | De onzichtbare native kiezer die over de tegel More is uitgerekt |
| `.whop-PaymentMethodMoreTile` | Overlooptegel met methode-iconen en een native kiezer |
| `.whop-PaymentMethodPanel` | Het detailpaneel van de geselecteerde methode onder de tegelrij (horizontale lay-out) |
| `.whop-PaymentMethodRadio` | De radio-indicator op een methoderij |
| `.whop-PaymentMethodRadioSelected` | Radio van de geselecteerde betaalmethode |
| `.whop-PaymentMethodRow` | De klikbare rij van een betaalmethode |
| `.whop-PaymentMethodRowSelected` | Rij van de geselecteerde betaalmethode |
| `.whop-PaymentMethods` | De lijst met betaalmethoden |
| `.whop-PaymentMethodSelected` | Toegevoegd aan de geselecteerde betaalmethode — de rij plus het uitgeklapte detailgebied |
| `.whop-PaymentMethodSeparated` | Toegevoegd aan een methode-item, of een uitklapper voor meer methoden, zolang die als eigen gescheiden kaart wordt weergegeven |
| `.whop-PaymentMethodsSeparated` | Gescheiden accordeonlijst met methoden |
| `.whop-PaymentMethodTile` | Eén methodetegel in de horizontale tegelrij |
| `.whop-PaymentMethodTileRow` | Horizontale rij met methodetegels, met overloopmethoden in de laatste tegel More |
| `.whop-PaymentMethodTileSelected` | Tegel van de geselecteerde betaalmethode |
| `.whop-PaymentMoreRow` | De uitklaprij "N more payment methods" |
| `.whop-PaymentPayerDocument` | Valutaspecifieke velden voor het identiteitsdocument van de koper |
| `.whop-PaymentPayerDocumentError` | Fout bij het identiteitsdocument van de koper |
| `.whop-PaymentPayerDocumentLabel` | Label voor het identiteitsdocument van de koper |
| `.whop-PaymentPayerDocumentType` | Kiezer voor het type identiteitsdocument van de koper |
| `.whop-PaymentSavedMethod` | Specifiek één opgeslagen betaalmethode — heeft ook PaymentMethod |
| `.whop-PaymentSavedMethodHint` | Het detail aan het einde van de opgeslagen methode — de vervaldatum van een kaart |
| `.whop-PaymentSavedMethodRow` | Specifiek de klikbare rij van een opgeslagen methode — heeft ook PaymentMethodRow |
| `.whop-PaymentSavedMethodRowSelected` | Rij van de geselecteerde opgeslagen betaalmethode |
| `.whop-PaymentSavedMethods` | Specifiek de lijst met opgeslagen methoden — heeft ook PaymentMethods, zodat één regel beide lijsten stylet |
| `.whop-PaymentSavedMethodSeparated` | De gescheiden markering specifiek op een opgeslagen methode |
| `.whop-PaymentSavedMore` | De bediening die de volgende pagina met opgeslagen betaalmethoden ophaalt |
| `.whop-PaymentSavedMoreSpinner` | De spinner die wordt getoond terwijl de volgende pagina met opgeslagen betaalmethoden laadt |
| `.whop-PaymentSettlementNotice` | De hint over de verwerkingstermijn bij methoden waarvan de matrixconfiguratie er een declareert |

```ts theme={null}
const payments = whop.payments.create({
  appearance: {
    classes: {
      'whop-Address': { borderRadius: '8px', fontWeight: '600' },
      'whop-AddressErrorSummary': { borderRadius: '8px', fontWeight: '600' },
      'whop-AddressField': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

// 90 classes use this shape
payments.update({
  appearance: { classes: { 'whop-Address': { fontWeight: '700' } } }
});
```

Geef in React `appearance` mee aan `<Payments>`. Stel het globaal in met `WhopElements({ appearance })`.

## Parameters

**order** `[WhopPaymentMethodType]`

Tegelvolgorde voor deze mount, die `methodOrder` van de controller overschrijft. Vermelde typen nemen hun positie in de lijst in; de rest behoudt de oorspronkelijke volgorde erachter.

**selection** `Binding\<WhopPaymentSelection\>?`

Leest de huidige selectie en de volledigheid ervan terug. De controller houdt beide in elk geval bij.

## `WhopPaymentSelection`

Wat een selectie teruggeeft:

* `isComplete: Bool`: de geselecteerde methode heeft alles wat ze nodig heeft
* `type: WhopPaymentMethodType?`: de geselecteerde methode
* `displayName: String?`: het label ervan, zoals de matrix het schrijft
* `category: String?`: `card`, `wallet`, `bank_debit`, …

## Statussen

Toont skelettegels terwijl de methodematrix laadt, en de foutmelding wanneer het lezen mislukt. Een methode waarvan deze build de categorie niet kan uitvoeren, wordt overgeslagen in plaats van als kapotte tegel te worden weergegeven. Het selecteren van een wallet vervangt het bevestigingsoppervlak door Apple Pay.

## Goed om te weten

* Apple Pay heeft niets van je app nodig: geen merchant identifier, geen `In-App Payments`-capability. De merchant is degene die op het Whop-account is geregistreerd, en de tegel wordt weergegeven wanneer het apparaat kan betalen.
* Een methode die een `secure`-veld declareert, geeft dat weer als gehost invoerveld. Die waarden komen nooit in je proces terecht.
* De opgeslagen methoden van een ingelogde koper verschijnen boven de nieuwe. Mount [`WhopEmailElement`](https://docs.whop.com/nl/elements/latest/payments/email#swift) om de inlog aan te bieden die de inloggegevens oplevert; het kiezen van een opgeslagen rij verzamelt niets en maakt een verwijzing aan.
* Een kaartafschrijving die termijnniveaus publiceert, toont een plankiezer in het kaartpaneel. Een plan dat de kaart van de koper niet kan gebruiken, wordt ingeklapt in plaats van gedimd, en een plan waarvan de regio niet bij het factuurland past, wordt geweigerd voordat er een tokenizer wordt uitgevoerd.
* Een markt die een identiteitsdocument vereist (momenteel een `ars`-afschrijving) geeft de typekiezer en het nummerveld in het paneel weer. Dat nummer gaat, anders dan de kaart, via je app naar de tokenizer en bereikt Whop nog steeds nooit.
* Waarden van kaarten en beveiligde velden worden vóór het aanmaken van het token getokeniseerd, zodat het bevestigingstoken het enige is dat door je app gaat.
* Mount [`WhopAddressElement`](https://docs.whop.com/nl/elements/latest/payments/address#swift) ernaast wanneer een methode een factuurland nodig heeft: de tegellijst wordt beperkt tot de methoden die dat land toestaat.

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

**order** `string[]`

Weergavevolgorde van methoden, met de semantiek van `paymentMethodOrder` van Stripe. Niet-vermelde typen behouden hun oorspronkelijke relatieve volgorde achter de vermelde. Kan ook eenmalig op `<Payments>` worden ingesteld.

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

Wordt geactiveerd bij elke wijziging van selectie en volledigheid. Laat je verzendknop afhangen van `complete`.

**style** `StyleProp\<ViewStyle\>`

Toegepast op de buitenste `View` van het element. Gebruik voor thema's bij voorkeur `appearance.parts` op de provider, dat elk element op dit oppervlak dekt. Let op: de namen van React Native-onderdelen vormen momenteel een eigen set, niet de `whop-*`-klassenamen van het web, dus een appearance-object voor het web is niet ongewijzigd over te zetten.

**fallback** `ReactNode`

Wordt weergegeven in plaats van het ingebouwde skelet terwijl het element laadt.

**onReady** `() =\> void`

Wordt eenmaal geactiveerd zodra het element interactief is. `<Payments>` groepeert deze, dus de eigen `onLoadingChange` daarvan is meestal wat je nodig hebt.

**onError** `(error: \{ message: string; code?: string \}) =\> void`

Een laad- of configuratiefout voor dit element. Het element geeft in beide gevallen zijn eigen foutscherm weer.

## `PaymentChangePayload`

Wat `onChange` teruggeeft:

* `complete: boolean`: de geselecteerde methode heeft alles wat ze nodig heeft
* `type?: string`: het geselecteerde methodetype, bijv. `card`
* `method?: { type, category, template, display_name }`: de matrixvermelding van de geselecteerde methode

## Statussen

Drie skeletrijen totdat de methodematrix binnen is, daarna de tegels. Het selecteren van een tegel klapt het detailgebied eronder uit. `onChange` meldt `complete` wanneer de geselecteerde methode alles heeft wat ze nodig heeft, en daar hangt je verzendknop van af. Een afschrijving zonder geschikte methode geeft een verklarende lege status weer in plaats van niets.

## 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.
* Apple Pay en Google Pay tonen allebei de eigen sheet van het platform. Geen van beide heeft iets van je nodig: Apple Pay gebruikt de merchant die op het Whop-account is geregistreerd, dus er is geen merchant identifier om mee te geven en geen capability om toe te voegen in Xcode, en `googlePayMerchantName` stelt alleen de naam in die in de sheet wordt getoond, standaard Whop.
* Doorverwijsmethoden en 3D Secure openen `ASWebAuthenticationSession` op iOS en Custom Tabs op Android. Altijd de systeembrowser, nooit een WebView, zodat de pagina van de uitgever buiten de vertrouwensgrens van je app blijft.
* Stel `returnUrl` op `<Payments>` in op een **https**-URL die je zelf host. De API weigert alles behalve https of loopback (`PaymentsApi::ValidateReturnUrl`), dus een aangepast app-schema is hier niet beschikbaar. Je registreert geen deep link: nadat de uitgever doorverwijst, pollt `handleNextAction` de betaling tot die is afgerond en sluit de browser zelf.

> [!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).


## Related topics

- [Payments](https://docs.whop.com/nl/elements/latest/payments/overview.md)
- [Bouw een checkout met payment elements](https://docs.whop.com/nl/developer/guides/payment-elements.md)
- [CardElement](https://docs.whop.com/nl/elements/latest/payments/card.md)
