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

> Viser tilgængelige betalingsmetoder og indsamler den valgte metodes påkrævede felter og oplysninger. Brug `change` til at aktivere din betalingsknap. I dens aktiveringshandler kalder du `payments.createConfirmationToken()`. Bekræft tokenet på serversiden, og send derefter et eventuelt afventende trin til `payments.handleNextAction(…)`. Brug `addressChange` til adresseafhængige opdateringer.

> [!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). Angiv props og callbacks via create-indstillingerne eller som React-props. Behold det oprettede handle eller React-`ref` for at kalde `select()`.

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

> [!NOTE]
>
> **Venter på `BrandingElement`.** Dette element forbliver i sin indlæsningstilstand, indtil `BrandingElement` er monteret i det samme Payments-handle.

Monteres inde i et `WhopPayments`-scope. Renderer de metodefliser, opkrævningen tilbyder, og derefter det, den valgte metode indsamler: kortfelterne, de felter, den erklærer, eller Apple Pay-knappen.

Montér inde i `<Payments>`, som ejer opkrævningen og bekræftelsestokenet. `<Payments>` monteres selv inde i `<WhopElements>`. Det renderer metodefliserne for opkrævningen og indsamler det, den valgte metode erklærer, så et kort, et wallet-ark og en bankomdirigering er den samme ene linje.

```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()
            }
        }
    }
}
```

Eksempeldata. [Åbn Playground](https://docs.whop.com/da/elements/latest/payments/overview#playground).

[PaymentElement kørende på Android i React Native-eksempelappen](https://app.revyl.ai/embed/c05028fb-0d33-4f36-b6f9-5339a4b9a054?controls=0)

## Props

**order** `string[]`

Styrer visningsrækkefølgen i begge layouts. Angivne typer vises først i rækkefølge. Ikke-angivne typer bevarer deres indbyrdes rækkefølge. Påvirker ikke tilgængeligheden. Standard er `[]`.

**wallets** `object`

Styrer, hvilke wallets elementet tilbyder. Hver nøgle har standardværdien `'auto'`, som tilbyder wallet'en overalt, hvor kontoen, køberens enhed og opkrævningen understøtter den. `'never'` fjerner den pågældende wallet fra metodelisten. Brug det, når din side tegner sine egne Apple Pay-, Google Pay- eller PayPal-knapper med `paymentRequest`, så køberne kun ser hver wallet én gang. `payPal: 'never'` fjerner PayPal-metoden. Gemte betalingsmetoder påvirkes ikke. Standard er `{}`. Siden `v1.8.0`.

**egenskaber**

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

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

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

**fields** `object`

Styrer indsamlingen af faktureringsoplysninger. `billingDetails: 'minimal'` (standard) følger hver metodes matrix. Metoder indsamler som standard navn og landets fulde format. En tilsidesættelse kan indsamle kun det erklærede minimum eller ingenting. For kort er minimum navn på kortet, land og postnummer. `'full'` kræver navn og landets fulde format for hver ny metode. `'never'` skjuler blokken. `address: 'minimal'` indsamler kun hver metodes erklærede minimum plus et land, hvor dette minimum mangler et (og også postnummeret, når `billingDetails: 'full'` angiver, at checkouten er momspligtig), undtagen for wallets, krypto, bankdebiteringer, bankoverførsler, card-present og in-app-køb, som slet ikke indsamler nogen adresse, og undtagen for en metode, hvis udbyder kræver den fulde faktureringsadresse (`requires_full_billing_address`), hvis flise følger de samme regler som en checkout uden markering; ellers har den forrang over `billingDetails: 'full'`; brug den, når sælgeren ikke indsamler en fuld faktureringsadresse. `phone: 'never'` skjuler kun inputtet til faktureringstelefon, når din formular allerede indsamler det; angiv `billingDetails.phone` til `createConfirmationToken` for metoder, der kræver det. Angiv i stedet adressen til `createConfirmationToken`. Landevælgeren omfatter kun lande, der understøttes af metoden og betalingsvalutaen. Når en afbetalingsplan er valgt, indsnævres den til de lande, planen betjener — faktureringslandet er det transaktionsland, opkrævningen behandles under. Den låses, når kun ét er tilgængeligt. Standard er `{"billingDetails":"minimal"}`.

**egenskaber**

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

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

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

**defaultValues** `object`

Forudfylder faktureringsoplysningerne, når hver metodes faktureringsblok renderes første gang. Køberen kan redigere hvert forudfyldt felt. `address.country` er en ISO 3166-1 alpha-2-kode og gælder kun, når den valgte metode accepterer den. `phone` udfylder inputtet til faktureringstelefon for metoder, der indsamler et, i E.164-format såsom `+14155552671`; et nummer uden for metodens understøttede telefonlande ignoreres. Kun felter, som blokken renderer, forudfyldes og sendes. Angiv alt andet til `createConfirmationToken` i `billingDetails`. Siden `v1.1.0`.

**egenskaber**

**billingDetails** `object`

**egenskaber**

**name** `string`

**phone** `string`

**address** `object`

**egenskaber**

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

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

Vælgerens layout. `accordion` (standard) stabler metoderne og udvider detaljerne inline. `horizontal` viser fliser med ens bredde uden rulning med detaljerne for den valgte nedenunder. Efter fire metoder åbner en More-flise en indbygget vælger. Den metode, der vælges dér, optager den sidste flise indtil næste valg. Valg og bekræftelse fungerer på samme måde. Standard er `"accordion"`.

**separated** `boolean`

Kun `accordion`. Tilføjer afstand og separat kortstyling mellem metoderne. Ignoreres, når `layout` er `horizontal`. Standard er `false`.

**autoSelect** `boolean`

Om den første tilbudte metode skal vælges efter opløsning. Standardværdien `true` respekterer `order` og udsender `selected` og `change` som ved en køberinteraktion. Den kører én gang før køberinteraktion og gør intet, når ingen metode tilbydes. Sæt `false` for at montere uden valg. Uafhængigt heraf falder valget tilbage til den første tilbudte metode, hvis en opdatering fjerner den valgte metode. Et element uden valg forbliver uden valg. Standard er `true`.

## Events

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

### `onChange`

Udløses, når valget ændres. `complete: true` betyder, at køberen har valgt en metode og udfyldt dens kortfelter eller påkrævede input. Brug det til at aktivere bekræftelse. `paymentMethod` er den valgte betalingsmetode, gemt eller ny, eller `null`, mens intet er valgt: `displayName` og `icons` betegner valget, som elementet viser det (med `balance.imageUrl`, billedet af en saldos ejer), `card` indeholder et korts netværk, sidste fire cifre og finansieringstype, `requiresBillingPhone` angiver, om metoden kræver et telefonnummer i faktureringsoplysningerne, og `countries` angiver, hvorfra metoden kan betale i opkrævningens valuta. `type`, `requiresBillingPhone` og `method` på øverste niveau er forældede: læs dem fra `paymentMethod`. `supportsBuyerFee` på øverste niveau er også forældet, uden erstatning: Whop prissætter selv sit servicegebyr for købere.

**payload** `PaymentElementChangeEvent`

**egenskaber**

**complete** `boolean` *required*

Om køberen har valgt en metode og udfyldt dens kortfelter eller påkrævede input. Brug det til at aktivere bekræftelse.

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

Den valgte betalingsmetode eller `null`, mens intet er valgt.

**egenskaber**

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

Den gemte betalingsmetode, køberen valgte, eller `null` for en metode, køberen indtaster nu, eller en saldo.

**type** `string` *required*

Betalingsmetodens type: `card`, `klarna`, `apple_pay`, `balance` osv.

**category** `string` *required*

Den familie, typen tilhører, såsom `card`, `wallet`, `bnpl` eller `balance`.

**displayName** `string` *required*

Hvad valget skal kaldes: en gemt metodes egen etiket ("Visa •••• 4242", "Cash App \$tag"), en saldos navn ("Acme", "Personal Balance"), et korts netværk og sidste fire cifre, mens køberen taster det, eller ellers metodens eget navn ("Klarna").

**icons** `PaymentMethodIcons`

Valgets ikongrafik: en gemt metodes egne ikoner, et indtastet korts netværksgrafik eller ellers metodens ikoner. Altid et ikonsæt med SVG- og PNG-udgaver.

**egenskaber**

**square** `PaymentMethodIconVariants | null`

**egenskaber**

**light** `object` *required*

**egenskaber**

**svg** `string` *required*

**dark** `object` *required*

**egenskaber**

**svg** `string` *required*

**card** `PaymentMethodIconVariants | null`

**egenskaber**

**light** `object` *required*

**egenskaber**

**svg** `string` *required*

**dark** `object` *required*

**egenskaber**

**svg** `string` *required*

**balance** `object`

Hvad der vides om et saldovalg ud over dets type: `imageUrl` er billedet af saldoens ejer, en enkelt rasterbillede-URL i stedet for et ikonsæt, som vises i stedet for `icons`. Fraværende for andre metoder og for en saldo, hvis ejer ikke har noget billede.

**egenskaber**

**imageUrl** `string`

**card** `object`

Hvad der vides om et kortvalg: et gemt korts oplysninger eller et indtastet korts, mens køberen taster. Fraværende for andre metoder.

**egenskaber**

**network** `string`

**last4** `string`

**funding** `string`

**requiresBillingPhone** `boolean` *required*

Om metoden kræver et telefonnummer i faktureringsoplysningerne, også når `fields.phone` deaktiverer elementets eget telefoninput.

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

De landekoder med to små bogstaver, som metoden kan betale fra i opkrævningens valuta.

**type** `string` *deprecated*

> [!WARNING]
>
> Forældet. Brug `paymentMethod.type`.

**supportsBuyerFee** `boolean` *deprecated*

> [!WARNING]
>
> Forældet. Whop prissætter selv sit servicegebyr for købere, så en side har ingen brug for det. Fjernes i næste major-version.

**requiresBillingPhone** `boolean` *deprecated*

> [!WARNING]
>
> Forældet. Brug `paymentMethod.requiresBillingPhone`.

**method** `object` *deprecated*

> [!WARNING]
>
> Forældet. Brug `paymentMethod`. Fraværende, når køberen vælger en gemt metode.

**egenskaber**

**type** `string` *required*

**category** `string` *required*

**template** `string` *required*

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

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

**egenskaber**

**country** `string` *required*

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

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

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

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

### `onAddressChange`

Udløses ca. 300 ms efter, at den interne faktureringsadresse ændres. Brug det til moms, forsendelse eller andre adresseafhængige opdateringer. `country` er en ISO 3166-1 alpha-2-kode. Payloaden udelader andre adressenøgler, når de er tomme eller ikke bruges i det pågældende land. `complete: true` betyder, at faktureringsblokken er gyldig og komplet. Denne event udløses kun, mens betalingselementet ejer adresseindsamlingen. Med `fields.billingDetails: 'never'` skal du bruge din egen adressekilde. Med et monteret `AddressElement` skal du bruge dets `change`-event.

**payload** `object`

**egenskaber**

**complete** `boolean` *required*

**address** `object` *required*

**egenskaber**

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string` *required*

### `onLoaderStart`

Kører, efter at indlæsningsskelettet først er tegnet, og før `onReady`.

### `onReady`

Kører efter elementets første fuldstændige rendering.

### `onError`

Kører, når elementet ikke kan indlæses eller går ned. Fallback-visningen forbliver synlig. Brug `code` til programmatisk håndtering. `sourceKey` identificerer en host-state-kilde, der fejlede.

**e** `object`

**egenskaber**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Metoder

Kald disse på det handle, som `create` returnerer, eller via en React-`ref`.

### `select`

Vælg en metode via samme vej som en køberinteraktion. For eksempel udvider `select('cashapp')` flisen og udsender `selected` og `change`. Kort forbliver `complete: false`, indtil deres felter er udfyldt. Ukendte, utilgængelige eller beløbsbegrænsede metoder afvises med koden `METHOD_NOT_OFFERED`. `select(null)` rydder valget og udsender `change` med `complete: false`. Brug sammen med `autoSelect={false}` for fuld ekstern kontrol.

**Parametre**

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

**Returnerer** `Promise<void>`

### `mount`

Monterer elementet i `target` og begynder indlæsningen. React-komponenter monterer sig selv.

**Parametre**

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

### `destroy`

Fjerner elementet og frigiver dets frame og abonnementer. Du kan kalde den mere end én gang. React fjerner elementet automatisk.

### `update`

Fletter nye props ind i det monterede element. I React ændrer du i stedet komponentens props.

**Parametre**

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

## Styling

Style disse dele via `appearance.classes`. Brug camel case eller kebab case til egenskabsnavne, og medtag enheder. Sidens stylesheets kan ikke nå elementets frame. Frameworket validerer hver deklaration, før den indsættes.

| Klasse | Rammer |
| - | - |
| `.whop-Address` | Rodelementet for adresseformularen |
| `.whop-AddressErrorSummary` | Opsummeringslinjen, der vises, når valideringen afslører manglende eller ugyldige felter |
| `.whop-AddressField` | Én feltcelle i adresseformularen |
| `.whop-AddressFieldError` | Fejllinjen for et adressefelt: under feltet i det fulde layout, under gruppen for en samlet besked i det kompakte layout |
| `.whop-AddressFieldInput` | Et tekstinput i adresseformularen |
| `.whop-AddressFieldInputInvalid` | Tilføjes til et adresseinput, mens det ikke består valideringen |
| `.whop-AddressFieldInvalid` | Tilføjes til en kompakt feltcelle, mens den ikke består valideringen |
| `.whop-AddressFieldLabel` | Etiket for adressefelt: over feltet eller inde i det med flydende etiketter |
| `.whop-AddressFieldSelect` | En select (land, stat, organisationstype) i adresseformularen |
| `.whop-AddressGroup` | Den indrammede gruppe, der rummer alle felter i det kompakte layout |
| `.whop-AddressLine2Toggle` | Toggle for sammenklappet adresselinje 2 |
| `.whop-AddressManualEntry` | Tekstknappen "Enter address manually" under den sammenklappede formular — udvider landets fulde format |
| `.whop-AddressSearchButton` | Søgeknappen i den bageste kant af gadefeltet på en telefon |
| `.whop-AddressSuggestion` | Én forslagsrække i autocomplete-overlayet |
| `.whop-AddressSuggestionActive` | Tilføjes til den forslagsrække, der er aktiv via tastatur/markør |
| `.whop-AddressSuggestionManual` | Rækken "Enter address manually", der afslutter forslagslisten |
| `.whop-AddressSuggestions` | Autocomplete-overlayet med forslag, forankret til feltet adresselinje 1 |
| `.whop-AddressSuggestionsEmpty` | Den diskrete linje, der vises, når forespørgslen er afsluttet uden adressematch |
| `.whop-CardField` | Felt til kortnummer, udløbsdato eller sikkerhedskode |
| `.whop-CardFieldError` | Valideringsmeddelelse for kort |
| `.whop-CardFieldGroup` | De grupperede kortfelter — nummer øverst, udløbsdato og sikkerhedskode nedenunder |
| `.whop-CardFieldInput` | PCI-inputcontainer med kant |
| `.whop-CardFieldInputFocused` | PCI-inputcontainer med fokus |
| `.whop-CardFieldInputInvalid` | Ugyldig eller ufuldstændig PCI-inputcontainer |
| `.whop-CardLabel` | Etiket for kortoplysninger |
| `.whop-Payment` | Rodelementet for betalingselementet |
| `.whop-PaymentBalance` | Én wallet i saldofeltet |
| `.whop-PaymentBalanceHint` | Wallet'ens tilgængelige beløb i opkrævningsvalutaen |
| `.whop-PaymentBalanceList` | Saldofeltets rulbare liste over køberens wallets |
| `.whop-PaymentBalanceMore` | Sentinel-rækken, der henter flere saldi, når den rulles ind i visningen |
| `.whop-PaymentBalanceRow` | Den klikbare saldorække |
| `.whop-PaymentBalanceRowSelected` | Valgt saldorække |
| `.whop-PaymentBalanceRowUnavailable` | En wallet, der ikke kan betale lige nu — blokeret eller tom — nedtonet og deaktiveret |
| `.whop-PaymentBillingBlock` | Betalingselementets interne blok med faktureringsadresse |
| `.whop-PaymentCardFields` | Panelet med inline-kortfelter |
| `.whop-PaymentCompactBalance` | Den valgte saldo på en kompakt direkte checkout |
| `.whop-PaymentCompactSavedMethod` | Den valgte gemte metode på en kompakt direkte checkout |
| `.whop-PaymentCurrencyFallback` | Skiftet til fallback-valutaen, når intet tilbydes |
| `.whop-PaymentDetailIcon` | Skabelonikonet ved siden af detaljeområdets forklaring |
| `.whop-PaymentDetailRegion` | Det udvidede detaljeområde for en valgt metode — indsamlingsflader først (inline-kortfelter, angivne inputs), derefter forklaringen og oplysningslinjerne som den nederste blok |
| `.whop-PaymentDetailSubtext` | Samtykketeksten under forklaringen på wallet-metoder |
| `.whop-PaymentDetailText` | Detaljeområdets forklaringslinje |
| `.whop-PaymentError` | Fejlpanel for utilgængelige betalingsmetoder |
| `.whop-PaymentFieldError` | Invalid-beskeden under et angivet input |
| `.whop-PaymentFieldInput` | Et angivet metodeinput i detaljeområdet |
| `.whop-PaymentFieldInputInvalid` | Tilføjes til et angivet input, mens dets værdi ikke opfylder det angivne format |
| `.whop-PaymentFieldLabel` | Etiket for angivet betalingsfelt |
| `.whop-PaymentInstallmentDetail` | Beløbet pr. rate i en række for en afdragsmulighed |
| `.whop-PaymentInstallmentLabel` | Etiketten på en række for en afdragsmulighed |
| `.whop-PaymentInstallmentList` | Afdragsvælgerens liste over muligheder |
| `.whop-PaymentInstallmentRadio` | Radioindikatoren på en række for en afdragsmulighed |
| `.whop-PaymentInstallmentRow` | Én række for en afdragsmulighed |
| `.whop-PaymentInstallmentRowSelected` | Den valgte række for en afdragsmulighed |
| `.whop-PaymentInstallments` | Betalingsmetodens afdragsvælger |
| `.whop-PaymentInstallmentsLabel` | Afdragsvælgerens overskrift |
| `.whop-PaymentInstallmentsNotice` | Ansvarsfraskrivelsen om udstedergebyr under et valgt niveau uden angivet gebyr |
| `.whop-PaymentMandateLink` | Linket til mandatvilkårene inde i mandatmeddelelsen |
| `.whop-PaymentMandateNotice` | Meddelelsen om mandatgodkendelse på metoder, hvis matrixkonfiguration angiver et mandat |
| `.whop-PaymentMethod` | Én betalingsmetode — rækken plus dens udfoldelige detaljeområde |
| `.whop-PaymentMethodDetail` | Det udfoldelige område, der viser den valgte metodes detaljer — inline-kortfelter, forklaring eller angivne inputs |
| `.whop-PaymentMethodIcon` | Metodeikonet på en række |
| `.whop-PaymentMethodLabel` | Metodens visningsnavn på en række |
| `.whop-PaymentMethodMoreSelect` | Den usynlige native select, der er strakt hen over More-feltet |
| `.whop-PaymentMethodMoreTile` | Overløbsfelt med metodeikoner og en native vælger |
| `.whop-PaymentMethodPanel` | Den valgte metodes detaljepanel under feltrækken (vandret layout) |
| `.whop-PaymentMethodRadio` | Radioindikatoren på en metoderække |
| `.whop-PaymentMethodRadioSelected` | Valgt radio for betalingsmetode |
| `.whop-PaymentMethodRow` | Den klikbare række for betalingsmetode |
| `.whop-PaymentMethodRowSelected` | Valgt række for betalingsmetode |
| `.whop-PaymentMethods` | Listen over betalingsmetoder |
| `.whop-PaymentMethodSelected` | Tilføjes til den valgte betalingsmetode — dens række plus dens udvidede detaljeområde |
| `.whop-PaymentMethodSeparated` | Tilføjes til en metodepost eller en udvider for flere metoder, mens den renderes som sit eget adskilte kort |
| `.whop-PaymentMethodsSeparated` | Adskilt accordion-liste over metoder |
| `.whop-PaymentMethodTile` | Ét metodefelt i den vandrette feltrække |
| `.whop-PaymentMethodTileRow` | Vandret række af metodefelter med overløbsmetoder i det sidste More-felt |
| `.whop-PaymentMethodTileSelected` | Valgt felt for betalingsmetode |
| `.whop-PaymentMoreRow` | Udviderrækken "N more payment methods" |
| `.whop-PaymentPayerDocument` | Valutaspecifikke felter til køberens identitetsdokument |
| `.whop-PaymentPayerDocumentError` | Fejl i køberens identitetsdokument |
| `.whop-PaymentPayerDocumentLabel` | Etiket for køberens identitetsdokument |
| `.whop-PaymentPayerDocumentType` | Vælger af typen af køberens identitetsdokument |
| `.whop-PaymentSavedMethod` | Specifikt én gemt betalingsmetode — har også PaymentMethod |
| `.whop-PaymentSavedMethodHint` | Den gemte metodes efterstillede detalje — et korts udløbsdato |
| `.whop-PaymentSavedMethodRow` | Specifikt den klikbare række for gemt metode — har også PaymentMethodRow |
| `.whop-PaymentSavedMethodRowSelected` | Valgt række for gemt betalingsmetode |
| `.whop-PaymentSavedMethods` | Specifikt listen over gemte metoder — har også PaymentMethods, så én regel styler begge lister |
| `.whop-PaymentSavedMethodSeparated` | Specifikt den adskilte markør på en gemt metode |
| `.whop-PaymentSavedMore` | Kontrollen, der henter den næste side af gemte betalingsmetoder |
| `.whop-PaymentSavedMoreSpinner` | Spinneren, der vises, mens den næste side af gemte betalingsmetoder indlæses |
| `.whop-PaymentSettlementNotice` | Tippet om afregningsvindue på metoder, hvis matrixkonfiguration angiver et |

```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' } } }
});
```

I React angiver du `appearance` til `<Payments>`. Sæt den globalt med `WhopElements({ appearance })`.

## Parametre

**order** `[WhopPaymentMethodType]`

Fliserækkefølge for denne montering, som tilsidesætter controllerens `methodOrder`. Angivne typer får deres placering i listen; resten bevarer deres indkommende rækkefølge bag dem.

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

Aflæser det aktuelle valg og dets fuldstændighed. Controlleren sporer begge dele under alle omstændigheder.

## `WhopPaymentSelection`

Det, et valg returnerer:

* `isComplete: Bool`: den valgte metode har alt, hvad den skal bruge
* `type: WhopPaymentMethodType?`: den valgte metode
* `displayName: String?`: dens etiket, som matrixen staver den
* `category: String?`: `card`, `wallet`, `bank_debit`, …

## Tilstande

Viser skeletfliser, mens metodematrixen indlæses, og fejlmeddelelsen, når læsningen mislykkes. En metode, hvis kategori denne build ikke kan køre, springes over i stedet for at blive renderet som en defekt flise. Når en wallet vælges, udskiftes bekræftelsesfladen med Apple Pay.

## Godt at vide

* Apple Pay kræver intet fra din app: ingen merchant identifier, ingen `In-App Payments`-capability. Forhandleren er den, der er registreret på Whop-kontoen, og flisen renderes, når enheden kan betale.
* En metode, der erklærer et `secure`-felt, renderer det som et hostet input. Disse værdier kommer aldrig ind i din proces.
* En indlogget købers gemte metoder vises over de nye. Montér [`WhopEmailElement`](https://docs.whop.com/da/elements/latest/payments/email#swift) for at tilbyde det login, der giver legitimationen; valg af en gemt række indsamler intet og udsteder en reference.
* En kortopkrævning, der udgiver afdragsniveauer, viser en planvælger inde i kortpanelet. En plan, som køberens kort ikke kan bruge, klappes sammen i stedet for at blive nedtonet, og en plan, hvis region ikke passer til faktureringslandet, afvises, før nogen tokenizer kører.
* Et marked, der kræver et identitetsdokument (i dag en `ars`-opkrævning), renderer typevælgeren og nummerfeltet inde i panelet. Dette nummer passerer gennem din app på vej til tokenizeren, i modsætning til kortet, og når stadig aldrig frem til Whop.
* Værdier fra kort og secure-felter tokeniseres før udstedelsen, så bekræftelsestokenet er det eneste, der passerer gennem din app.
* Montér [`WhopAddressElement`](https://docs.whop.com/da/elements/latest/payments/address#swift) ved siden af, når en metode kræver et faktureringsland: flisenlisten indsnævres til de metoder, som landet tillader.

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

**order** `string[]`

Metodernes visningsrækkefølge med Stripes `paymentMethodOrder`-semantik. Ikke-angivne typer bevarer deres indkommende indbyrdes rækkefølge bag de angivne. Kan også angives én gang på `<Payments>`.

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

Udløses ved hver ændring af valg og fuldstændighed. Gør din indsendelsesknap betinget af `complete`.

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

Anvendes på elementets ydre `View`. Til tematisering bør du foretrække `appearance.parts` på provideren, som dækker alle elementer på denne flade. Bemærk, at React Native-delenes navne i dag er deres eget sæt og ikke webbens `whop-*`-klassenavne, så et web-appearance-objekt kan ikke overføres uændret.

**fallback** `ReactNode`

Renderes i stedet for det indbyggede skelet, mens elementet indlæses.

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

Udløses, når elementet er interaktivt. `<Payments>` grupperer disse, så dens egen `onLoadingChange` er normalt den, du har brug for.

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

En indlæsnings- eller konfigurationsfejl for dette element. Elementet renderer under alle omstændigheder sin egen fejlvisning.

## `PaymentChangePayload`

Det, `onChange` returnerer:

* `complete: boolean`: den valgte metode har alt, hvad den skal bruge
* `type?: string`: den valgte metodetype, f.eks. `card`
* `method?: { type, category, template, display_name }`: den valgte metodes matrixpost

## Tilstande

Tre skeletrækker, indtil metodematrixen er indlæst, og derefter fliserne. Når en flise vælges, udvides dens detaljeområde under den. `onChange` rapporterer `complete`, når den valgte metode har alt, hvad den skal bruge, hvilket er det, der styrer din indsendelsesknap. En opkrævning uden nogen kvalificeret metode renderer en forklarende tom tilstand i stedet for ingenting.

## 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 forbliver uden for PCI-scope.
* Apple Pay og Google Pay viser begge platformens eget ark. Ingen af dem kræver noget fra dig: Apple Pay bruger den forhandler, der er registreret på Whop-kontoen, så der er ingen merchant identifier at angive og ingen capability at tilføje i Xcode, og `googlePayMerchantName` angiver kun det navn, der vises i arket, som standard Whop.
* Omdirigeringsmetoder og 3D Secure åbner `ASWebAuthenticationSession` på iOS og Custom Tabs på Android. Systembrowseren, aldrig en WebView, så udstederens side forbliver uden for din apps tillidsgrænse.
* Sæt `returnUrl` på `<Payments>` til en **https**-URL, du hoster. API'et afviser alt andet end https eller loopback (`PaymentsApi::ValidateReturnUrl`), så et brugerdefineret app-scheme er ikke tilgængeligt her. Du skal ikke registrere et deep link: efter at udstederen har omdirigeret, poller `handleNextAction` betalingen, indtil den er afsluttet, og lukker selv browseren.

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


## Related topics

- [Payments](https://docs.whop.com/da/elements/latest/payments/overview.md)
- [Byg en checkout med Payment Elements](https://docs.whop.com/da/developer/guides/payment-elements.md)
- [CardElement](https://docs.whop.com/da/elements/latest/payments/card.md)
