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

# PaymentRequest

> Low-level sheet voor Apple Pay, Google Pay of PayPal voor aangepaste knoppen, express checkout en verzendcallbacks. Wallettegels automatiseren deze flow via `payments.createConfirmationToken`. Wacht op `canMakePayment()` om de beschikbaarheid te controleren en de wallet voor te bereiden, en roep daarna `show(type)` synchroon aan in de handler van de gebruikersinteractie. De opgeleverde `ctok` is een bevestigingstoken met het voorvoegsel `ctok_`. Bevestig het server-side zoals een token dat door een element is aangemaakt. Een PayPal-token schrijft maximaal het totaal af dat PayPal aan de koper heeft getoond.

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

*Sinds `v1.0.0`.*

Maak deze [`Payments`](https://docs.whop.com/nl/elements/latest/payments/overview)-resource aan zonder een element te mounten: `whop.payments.paymentRequest.create({ … })` in vanilla of `useWhop().payments.paymentRequest.create({ … })` in React.

## Opties

Geef deze mee aan `whop.payments.paymentRequest.create({ … })`.

**accountId** `string` *required*

Account-ID, met het voorvoegsel `biz_`, waarbinnen elke client-side aanroep valt.

**currency** `string` *required*

Drieletterige ISO 4217-code voor de betalingsvaluta.

**amount** `number` *required*

Betalingsbedrag in de kleinste munteenheid. Wijzig het later met `update()`.

**setupFutureUsage** `"off_session" | "on_session"`

Stel dit alleen in nadat je toestemming voor opslaan hebt getoond. Markeert het token voor `off_session`- of `on_session`-gebruik.

**paymentMethodConfiguration** `PaymentMethodConfigurationShape`

Betaalmethodefilters in het formaat `enabled`, `disabled` en `include_platform_defaults` van de API. Ze beperken de wallets die `canMakePayment()` meldt: `disabled` verwijdert typen, `enabled` herstelt aangeboden typen en `include_platform_defaults: false` laat alleen ingeschakelde typen over. Ze voegen nooit een methode toe die het account niet aanbiedt. PayPal volgt het type `paypal`. Sinds `v1.9.0`.

**eigenschappen**

**enabled** `string[]`

**disabled** `string[]`

**include\_platform\_defaults** `boolean`

**requestPayerEmail** `boolean`

Vraag de sheet om het e-mailadres van de betaler — het bevestigingstoken vereist er een. Standaard `true`.

**requestPayerPhone** `boolean`

Vraag de sheet om het telefoonnummer van de betaler, geleverd als `payer.phone` in het resultaat — in E.164 als het kan worden geparset op basis van het land van het contact dat het heeft opgegeven, en anders zoals de wallet het gaf; `payer.country` is het factuurland. Google Pay verzamelt het via het factuuradres waar de sheet al om vraagt. PayPal verzamelt het via de contactsectie en weigert een account zonder telefoonnummer. Standaard `false`.

**requestShipping** `boolean`

Vraag de sheet om een verzendadres (en bied `shippingOptions` aan als die zijn opgegeven). PayPal vraagt altijd om een adres, omdat daarover de belasting wordt berekend, en retourneert het alleen als `shipping` wanneer dit is ingesteld. Standaard `false`.

**requestPromoCode** `boolean`

Bied het eigen promotiecodeveld van de sheet aan en beantwoord `onPromoCodeChange`. Apple Pay toont het veld op apparaten die Apple Pay versie 12 ondersteunen (iOS 15 en macOS 12); Google Pay toont het waar de Google Pay-configuratie van het account aanbiedingen toestaat. Andere apparaten openen de sheet zonder het veld. Standaard `false`. Sinds `v1.5.0`.

**appliedPromoCode** `string`

Een promotiecode die al op de afschrijving is toegepast, vooraf ingevuld in de sheet zodat de koper die kan zien, vervangen of verwijderen. Sinds `v1.5.0`.

**appliedPromoDescription** `string`

Wat `appliedPromoCode` doet, getoond naast de code in Google Pay. Het couponveld van Apple Pay heeft geen bijschrift. Sinds `v1.5.0`.

**countryCode** `string`

ISO 3166-1 alpha-2-landcode van het account voor de Apple Pay-sheet. Laat het weg om het gepubliceerde registratieland van het account te gebruiken. De sheet gebruikt standaard `US` wanneer geen van beide beschikbaar is.

**lineItems** `PaymentRequestLineItem[]`

Regelitems die de sheet onder het totaal vermeldt. Wijzig ze later met `update()`.

**eigenschappen**

**label** `string` *required*

**amount** `number` *required*

Kleinste munteenheid, net als `amount`.

**shippingOptions** `PaymentRequestShippingOption[]`

Verzendopties die de sheet aanbiedt wanneer `requestShipping` is ingesteld. Alleen voor weergave — werk `amount` bij vanuit je change-handler. De sheet opent met de eerste optie geselecteerd en activeert daarvoor geen `onShippingOptionChange`, dus `amount` moet de prijs ervan al bevatten. Wijzig ze later met `update()`.

**eigenschappen**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Weergavewaarde in de kleinste munteenheid. De resource berekent geen verzendkosten. Werk `amount` bij vanuit je handler.

## Methoden

Roep deze aan op de resource.

> [!WARNING]
>
> Roep `show` synchroon aan tijdens gebruikersactivatie. Wacht eerst op vereisten.

### `canMakePayment`

Retourneert de beschikbaarheid van elke wallet wanneer het account die aanbiedt, het apparaat die ondersteunt en de origin van deze pagina voor het account is goedgekeurd (first-party whop.com-pagina's zijn vooraf goedgekeurd; een merchantpagina heeft Apple Pay nodig die op het domein gereed is via de [Domains API](https://docs.whop.com/nl/api-reference/beta/domains/domain), en het aanbieden van Google Pay daar valt onder de [Google Pay API Terms of Service](https://payments.developers.google.com/terms/sellertos)). Op een pagina die zelf in een iframe staat, controleert Apple Pay in plaats daarvan het domein van de pagina op het hoogste niveau wanneer de browser dat beschikbaar stelt. Apple Pay in niet-WebKit-browsers is de desktopflow met overdracht naar de iPhone, dus mobiele apparaten melden het daar als niet beschikbaar — native Apple Pay in iOS-browsers wordt niet beïnvloed. `order` rangschikt de wallets op welke sheet native is in de browser — Apple Pay eerst in Safari, Google Pay eerst elders, PayPal als laatste — zodat expressknoppen met de beste bovenaan kunnen worden gestapeld. `payPal` meldt PayPal wanneer het account het in deze valuta aanbiedt, het bedrag binnen de limieten van PayPal valt, het verzoek niet om het telefoonnummer van de betaler vraagt (een `off_session`-verzoek mag \$0 zijn, wat PayPal opslaat zonder afschrijving), de scripts van PayPal op deze pagina laden en de origin van deze pagina voor het account is goedgekeurd, net als bij de andere wallets. Een pagina met een Content Security Policy moet de hosts van PayPal toestaan, die `contentSecurityPolicy()` bevat. Een pagina die de eigen v5 JavaScript SDK van PayPal al laadt, meldt `payPal: false`. Geef `types` mee om alleen de wallets te controleren die je opgeeft; `show(type)` vereist dat die wallet is gecontroleerd. `wallets` bevat de officiële knopafbeelding van elke beschikbare wallet (`light` en `dark` kleur en afbeelding). Dit bereidt `show()` voor. Wacht hier altijd eerst op.

**Parameters**

**filter** `object`

**eigenschappen**

**types** `("apple_pay" | "google_pay" | "paypal_express")[]`

**Retourneert** `Promise<WalletAvailability>`

**applePay** `boolean` *required*

**googlePay** `boolean` *required*

**payPal** `boolean`

**order** `("apple_pay" | "google_pay" | "paypal_express")[]`

De wallets gerangschikt op welke sheet native is in deze browser — Apple Pay eerst op WebKit, Google Pay eerst overal elders, PayPal als laatste — zodat expressknoppen met de beste bovenaan kunnen worden gestapeld. Ontbreekt bij door de consument opgegeven beschikbaarheid (previews) en bij berichten van vóór deze toevoeging. Een inline union, niet de WalletSheetType van payment-request: die module importeert deze al.

**wallets** `object`

De details van elke beschikbare wallet, met het wallettype als sleutel. Ontbreekt bij door de consument opgegeven beschikbaarheid (previews).

**eigenschappen**

**apple\_pay** `WalletDetails`

**eigenschappen**

**button** `WalletButtonArt`

De officiële knopafbeelding van de wallet. Ontbreekt wanneer er geen is gepubliceerd.

**eigenschappen**

**light** `object` *required*

Voor lichte pagina's.

**eigenschappen**

**color** `string` *required*

**image** `string` *required*

**dark** `object` *required*

Voor donkere pagina's.

**eigenschappen**

**color** `string` *required*

**image** `string` *required*

**google\_pay** `WalletDetails`

**eigenschappen**

**button** `WalletButtonArt`

De officiële knopafbeelding van de wallet. Ontbreekt wanneer er geen is gepubliceerd.

**eigenschappen**

**light** `object` *required*

Voor lichte pagina's.

**eigenschappen**

**color** `string` *required*

**image** `string` *required*

**dark** `object` *required*

Voor donkere pagina's.

**eigenschappen**

**color** `string` *required*

**image** `string` *required*

**paypal\_express** `WalletDetails`

**eigenschappen**

**button** `WalletButtonArt`

De officiële knopafbeelding van de wallet. Ontbreekt wanneer er geen is gepubliceerd.

**eigenschappen**

**light** `object` *required*

Voor lichte pagina's.

**eigenschappen**

**color** `string` *required*

**image** `string` *required*

**dark** `object` *required*

Voor donkere pagina's.

**eigenschappen**

**color** `string` *required*

**image** `string` *required*

### `show`

Open de geselecteerde wallet nadat je op `canMakePayment()` hebt gewacht, synchroon bij het indrukken: Apple vereist dat de sessie binnen de gebarenstack wordt aangemaakt, en PayPal opent daar zijn venster — een pop-up op desktop, het venster van PayPal op de pagina wanneer de pop-up wordt geblokkeerd en op mobiel. Geef `email` mee wanneer je pagina er al een heeft verzameld — de wallet neemt het over en vraagt nooit om een tweede. Met `requestPayerEmail: false` is het verplicht er een mee te geven, en weigert de wallet zonder te openen omdat bevestigingstokens een e-mailadres vereisen. Zolang de sheet open is, gooit `update()` een fout: beantwoord de change-events om de sheet te wijzigen. Roep het synchroon aan tijdens gebruikersactivering. Wacht eerst op vereisten, omdat browsers de activering intrekken over asynchrone stappen heen.

**Parameters**

**type** `"apple_pay" | "google_pay" | "paypal_express"` *required*

**provided** `object`

**eigenschappen**

**email** `string`

**Retourneert** `Promise<PaymentRequestResult>`

**ctok** `string` *required*

ID van het bevestigingstoken, met het voorvoegsel `ctok_`. Bevestig het server-side met je geheime sleutel.

**type** `"apple_pay" | "google_pay" | "paypal_express"` *required*

**payer** `object` *required*

`phone` is E.164 als het kon worden geparset op basis van het land van het contact, en anders zoals opgegeven; PayPal geeft er alleen een bij `requestPayerPhone` en weigert een account zonder telefoonnummer. `country` is het factuurland dat elke sheet verzamelt.

**eigenschappen**

**email** `string`

**name** `string`

**phone** `string`

**country** `string`

**billing** `object | null` *required*

Het volledige factuuradres dat het bevestigingstoken meedraagt, anders dan het afgeschermde adres in de change-events; `null` wanneer de wallet er geen gaf. Apple Pay en Google Pay geven het factuuradres van de kaart. Bij PayPal is het het adres dat de koper in PayPal heeft gekozen, waarover het totaal is belast.

**eigenschappen**

**address** `PaymentRequestAddress` *required*

**eigenschappen**

**name** `string`

De naam op het adres.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

> [!WARNING]
>
> Verouderd. Gebruik `name`.

Dezelfde waarde als `name`.

**phone** `string`

**shipping** `object | null` *required*

`null` tenzij `requestShipping` is ingesteld. `option` is de geselecteerde verzendoptie: de eerst aangeboden optie totdat de koper een andere kiest, en opnieuw de eerste wanneer een antwoord de opties heeft vervangen zonder de gekozen `id`. Apple Pay en Google Pay stellen het in wanneer er opties zijn aangeboden, PayPal nooit.

**eigenschappen**

**address** `PaymentRequestAddress`

**eigenschappen**

**name** `string`

De naam op het adres.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

> [!WARNING]
>
> Verouderd. Gebruik `name`.

Dezelfde waarde als `name`.

**phone** `string`

**option** `PaymentRequestShippingOption`

**eigenschappen**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Weergavewaarde in de kleinste munteenheid. De resource berekent geen verzendkosten. Werk `amount` bij vanuit je handler.

### `update`

Wijzig `amount`, `lineItems` en `shippingOptions` op deze instantie. Elke andere optie ligt vast bij `create()`: maak een nieuwe instantie aan om die te wijzigen.

**Parameters**

**patch** `object` *required*

**eigenschappen**

**amount** `number`

**lineItems** `PaymentRequestLineItem[]`

**eigenschappen**

**label** `string` *required*

**amount** `number` *required*

Kleinste munteenheid, net als `amount`.

**shippingOptions** `PaymentRequestShippingOption[]`

**eigenschappen**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Weergavewaarde in de kleinste munteenheid. De resource berekent geen verzendkosten. Werk `amount` bij vanuit je handler.

## Events

Abonneer je hieronder op events. Elke methode retourneert een functie om het abonnement op te zeggen.

> [!WARNING]
>
> Elke event-handler moet de gedocumenteerde antwoordmethode precies één keer aanroepen. Een handler die een fout gooit of wordt afgewezen voordat die antwoordt, laat die update direct mislukken.

### `onShippingAddressChange`

De koper heeft een verzendadres gekozen (vóór autorisatie afgeschermd: alleen plaats, staat, postcode en land; Apple Pay kort een Amerikaanse ZIP-code in tot vijf cijfers en laat de laatste drie tekens van een Canadese of Britse postcode weg). Antwoord met de totalen voor het adres en de geselecteerde verzendoptie: de eerste totdat de koper een andere kiest. `shippingOptions` vervangt de opties (een lege lijst verandert niets). Een gekozen optie blijft geselecteerd zolang het antwoord de `id` ervan behoudt; als het antwoord die weglaat, wordt de eerste optie de selectie zonder een `onShippingOptionChange`, dus prijs die. Elke fout in het antwoord blijft op het adres staan totdat een later antwoord voor een adres die wist: een fout die een `field` noemt (`city`, `state`, `postal_code`, `country`) markeert dat veld in Apple Pay, en Google Pay toont alleen de melding. Betalen wordt geweigerd zolang er een fout op het adres staat. Weiger een adres waarnaar je niet kunt verzenden met een `shipping_address_unserviceable`-fout zonder `field`. Bij Apple Pay, Google Pay en PayPal laat een handler die niet binnen 25 seconden heeft geantwoord het adres mislukken, net als een handler die een fout gooit, en wordt het latere antwoord genegeerd. PayPal activeert het met het adres dat de koper kiest, en een fout die een `field` noemt, weigert dat deel van het adres binnen PayPal. Roep `updateWith(…)` precies één keer per event aan. Een handler die een fout gooit of wordt geweigerd voordat hij het aanroept, laat die update meteen mislukken. Retourneert de functie om het abonnement op te zeggen.

**ev** `ShippingAddressChangeEvent`

**eigenschappen**

**address** `PaymentRequestAddress` *required*

Door de leverancier genormaliseerd adres van vóór de autorisatie. Het bevat alleen plaats, staat, postcode en land. Apple Pay kort de postcode in: een Amerikaanse ZIP-code tot de eerste vijf cijfers, en een Canadese of Britse postcode zonder de laatste drie tekens.

**eigenschappen**

**name** `string`

De naam op het adres.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

> [!WARNING]
>
> Verouderd. Gebruik `name`.

Dezelfde waarde als `name`.

**phone** `string`

**updateWith** `(update: PaymentRequestUpdate) =\> void` *required*

Roep dit precies één keer aan, binnen 25 seconden. Bij Apple Pay, Google Pay en PayPal laat een handler die dan nog niet heeft geantwoord het adres mislukken, net als een handler die een fout gooit, en wordt het latere antwoord genegeerd.

**parameters**

**update** `PaymentRequestUpdate` *required*

**eigenschappen**

**amount** `number`

**lineItems** `PaymentRequestLineItem[]`

**eigenschappen**

**label** `string` *required*

**amount** `number` *required*

Kleinste munteenheid, net als `amount`.

**shippingOptions** `PaymentRequestShippingOption[]`

Vervangt de verzendopties van de sheet. De geselecteerde optie blijft geselecteerd zolang de `id` ervan nog in de lijst staat; anders wordt de eerste optie de selectie, zonder `shippingOptionChange`, dus prijs die in hetzelfde antwoord. Een lege lijst verandert niets: weiger een adres waarnaar je niet kunt verzenden in plaats daarvan met een `shipping_address_unserviceable`-fout.

**eigenschappen**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Weergavewaarde in de kleinste munteenheid. De resource berekent geen verzendkosten. Werk `amount` bij vanuit je handler.

**errors** `PaymentRequestError[]`

**eigenschappen**

**code** `string`

Wat een verzendantwoord weigert. Een fout in een antwoord op `billingAddressChange` of `paymentMethodChange` weigert de kaart of methode waar dat event over ging, ongeacht de code.

Een van `"other"`, `"shipping_address_invalid"`, `"shipping_address_unserviceable"` of `"shipping_option_invalid"`.

**message** `string` *required*

**field** `"state" | "country" | "city" | "postal_code"`

Het adresveld waarover de fout gaat: een van de velden van het afgeschermde adres. Apple Pay markeert dat veld met de melding, ongeacht de `code`; Google Pay toont alleen de melding. Laat het weg bij een fout over het hele adres.

### `onShippingOptionChange`

De koper heeft een verzendoptie gekozen, of Apple Pay heeft de geselecteerde opnieuw gemeld: zodra alle adreswijzigingen zijn beantwoord en er geen meer wacht, activeert Apple Pay het voor de optie die nog geselecteerd is. Het wordt nooit geactiveerd na een antwoord dat de geselecteerde optie weglaat, waardoor de eerste optie zonder event de selectie wordt, dus elk totaal dat je antwoordt, prijst de geselecteerde optie: de eerste totdat de koper een andere kiest, de gekozen optie zolang je antwoorden de `id` ervan behouden, en opnieuw de eerste zodra een antwoord die weglaat. Contract alleen voor bedragen: `updateWith` bevat amount/lineItems/shippingOptions/errors. Een antwoord met `errors` weigert de optie totdat de koper er een kiest die je handler accepteert. Apple Pay heeft geen foutplek voor een verzendoptie, dus het behoudt het laatst geaccepteerde totaal, wat het antwoord verder ook bevat, en de melding van de eerste fout verschijnt wanneer de koper op Pay tikt. Google Pay toont de melding wanneer de optie wordt gekozen. Bij Apple Pay, Google Pay en PayPal weigert een handler die niet binnen 25 seconden heeft geantwoord de optie, net als een handler die een fout gooit, en wordt het latere antwoord genegeerd. Roep `updateWith(…)` precies één keer per event aan. Een handler die een fout gooit of wordt geweigerd voordat hij het aanroept, laat die update meteen mislukken. Retourneert de functie om het abonnement op te zeggen.

**ev** `ShippingOptionChangeEvent`

**eigenschappen**

**option** `object & Partial\<PaymentRequestShippingOption\>` *required*

Bevat altijd de geselecteerde `id`. Bevat de volledige optie wanneer die overeenkomt met een van de jouwe.

**eigenschappen**

**id** `string` *required*

**label** `string`

**detail** `string`

**amount** `number`

Weergavewaarde in de kleinste munteenheid. De resource berekent geen verzendkosten. Werk `amount` bij vanuit je handler.

**updateWith** `(update: PaymentRequestUpdate) =\> void` *required*

Roep dit precies één keer aan, binnen 25 seconden. Bij Apple Pay, Google Pay en PayPal weigert een handler die dan nog niet heeft geantwoord de optie, net als een weigering door de merchant, en wordt het latere antwoord genegeerd.

**parameters**

**update** `PaymentRequestUpdate` *required*

**eigenschappen**

**amount** `number`

**lineItems** `PaymentRequestLineItem[]`

**eigenschappen**

**label** `string` *required*

**amount** `number` *required*

Kleinste munteenheid, net als `amount`.

**shippingOptions** `PaymentRequestShippingOption[]`

Vervangt de verzendopties van de sheet. De geselecteerde optie blijft geselecteerd zolang de `id` ervan nog in de lijst staat; anders wordt de eerste optie de selectie, zonder `shippingOptionChange`, dus prijs die in hetzelfde antwoord. Een lege lijst verandert niets: weiger een adres waarnaar je niet kunt verzenden in plaats daarvan met een `shipping_address_unserviceable`-fout.

**eigenschappen**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Weergavewaarde in de kleinste munteenheid. De resource berekent geen verzendkosten. Werk `amount` bij vanuit je handler.

**errors** `PaymentRequestError[]`

**eigenschappen**

**code** `string`

Wat een verzendantwoord weigert. Een fout in een antwoord op `billingAddressChange` of `paymentMethodChange` weigert de kaart of methode waar dat event over ging, ongeacht de code.

Een van `"other"`, `"shipping_address_invalid"`, `"shipping_address_unserviceable"` of `"shipping_option_invalid"`.

**message** `string` *required*

**field** `"state" | "country" | "city" | "postal_code"`

Het adresveld waarover de fout gaat: een van de velden van het afgeschermde adres. Apple Pay markeert dat veld met de melding, ongeacht de `code`; Google Pay toont alleen de melding. Laat het weg bij een fout over het hele adres.

### `onBillingAddressChange`

De koper heeft een kaart geselecteerd, met het afgeschermde factuuradres (alleen plaats, staat, postcode en land): prijs het totaal opnieuw voor het adres waarover de afschrijving wordt belast. Apple Pay activeert het wanneer de koper een kaart selecteert, en Google Pay wanneer de sheet opent en telkens wanneer de koper van kaart wisselt. Antwoord met `updateWith({ amount })` in de kleinste munteenheid, `updateWith({})` om het huidige totaal te behouden, of `updateWith({ errors })` om de kaart te weigeren. Elk event wordt precies één keer beantwoord: een handler die een fout gooit, wordt geweigerd of niet binnen 10 seconden antwoordt, weigert de kaart, zodat de koper een andere kiest. Bij Apple Pay en Google Pay activeert dezelfde selectie daarna `paymentMethodChange`, en de sheet wordt bijgewerkt zodra beide zijn beantwoord. PayPal activeert het met elk verzendadres dat de koper in PayPal kiest, het adres waarop het token factureert en belast, en een weigering daar weigert dat adres binnen PayPal. Roep `updateWith(…)` precies één keer per event aan. Een handler die een fout gooit of wordt geweigerd voordat hij het aanroept, laat die update meteen mislukken. Retourneert de functie om het abonnement op te zeggen.

**ev** `BillingAddressChangeEvent`

**eigenschappen**

**address** `PaymentRequestAddress` *required*

Door de leverancier genormaliseerd factuuradres van vóór de autorisatie. Het bevat alleen plaats, staat, postcode en land.

**eigenschappen**

**name** `string`

De naam op het adres.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

> [!WARNING]
>
> Verouderd. Gebruik `name`.

Dezelfde waarde als `name`.

**phone** `string`

**updateWith** `(update: PaymentRequestUpdate) =\> void` *required*

Roep dit precies één keer aan. Een event dat 10 seconden onbeantwoord blijft, weigert de kaart, en de koper kiest een andere.

**parameters**

**update** `PaymentRequestUpdate` *required*

**eigenschappen**

**amount** `number`

**lineItems** `PaymentRequestLineItem[]`

**eigenschappen**

**label** `string` *required*

**amount** `number` *required*

Kleinste munteenheid, net als `amount`.

**shippingOptions** `PaymentRequestShippingOption[]`

Vervangt de verzendopties van de sheet. De geselecteerde optie blijft geselecteerd zolang de `id` ervan nog in de lijst staat; anders wordt de eerste optie de selectie, zonder `shippingOptionChange`, dus prijs die in hetzelfde antwoord. Een lege lijst verandert niets: weiger een adres waarnaar je niet kunt verzenden in plaats daarvan met een `shipping_address_unserviceable`-fout.

**eigenschappen**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Weergavewaarde in de kleinste munteenheid. De resource berekent geen verzendkosten. Werk `amount` bij vanuit je handler.

**errors** `PaymentRequestError[]`

**eigenschappen**

**code** `string`

Wat een verzendantwoord weigert. Een fout in een antwoord op `billingAddressChange` of `paymentMethodChange` weigert de kaart of methode waar dat event over ging, ongeacht de code.

Een van `"other"`, `"shipping_address_invalid"`, `"shipping_address_unserviceable"` of `"shipping_option_invalid"`.

**message** `string` *required*

**field** `"state" | "country" | "city" | "postal_code"`

Het adresveld waarover de fout gaat: een van de velden van het afgeschermde adres. Apple Pay markeert dat veld met de melding, ongeacht de `code`; Google Pay toont alleen de melding. Laat het weg bij een fout over het hele adres.

### `onPaymentMethodChange`

De koper heeft een betaalmethode geselecteerd: prijs het totaal daarvoor opnieuw, bijvoorbeeld met een toeslag op creditcards. Apple Pay activeert het wanneer de koper een kaart selecteert, en Google Pay wanneer de sheet opent en telkens wanneer de koper van kaart wisselt, steeds direct na de `billingAddressChange` van die kaart. `paymentMethod.type` is `card`. `paymentMethod.card` bevat wat de wallet over een kaart vertelt voordat de koper autoriseert: Apple Pay meldt de `funding` (Apple houdt het netwerk tot dan meestal achter), en Google Pay het `network`. `paymentMethod.billingAddress` is het afgeschermde factuuradres van de kaart. Antwoord met `updateWith({ amount, lineItems })` om opnieuw te prijzen, `updateWith({})` om het huidige totaal te behouden, of `updateWith({ errors })` om de methode te weigeren; `shippingOptions` wordt genegeerd. Apple Pay markeert een weigering op het factuurcontact van de kaart (op het genoemde `field` als dat is opgegeven) en houdt de Pay-knop tegen totdat de koper een andere methode kiest. Google Pay toont de melding op de kaart en weigert een tik op Pay daarvoor totdat de koper een kaart kiest die je accepteert. Een geweigerde kaart laat de totalen zoals ze waren, wat dit antwoord of het antwoord op de `billingAddressChange` ervan ook prijsde. Elk event wordt precies één keer beantwoord: een handler die een fout gooit, wordt geweigerd of niet binnen 10 seconden antwoordt, weigert de methode. Elke sheet wacht op je antwoord voordat de koper kan betalen. PayPal activeert het nooit. Roep `updateWith(…)` precies één keer per event aan. Een handler die een fout gooit of wordt geweigerd voordat hij het aanroept, laat die update meteen mislukken. Retourneert de functie om het abonnement op te zeggen.

**ev** `PaymentMethodChangeEvent`

**eigenschappen**

**paymentMethod** `PaymentRequestPaymentMethod` *required*

De methode die de koper heeft geselecteerd, zoals de wallet die vóór autorisatie beschrijft.

**eigenschappen**

**type** `string` *required*

`card` bij Apple Pay en Google Pay, die alleen kaarten melden; `paypal` bij PayPal.

**card** `object`

Wat de wallet over de kaart vertelt. Voordat de koper autoriseert, bij `paymentMethodChange`, meldt Apple Pay het financieringstype, meestal zonder het netwerk, en Google Pay het netwerk. Bij autorisatie melden Apple Pay en Google Pay beide.

**eigenschappen**

**network** `string`

**funding** `"credit" | "debit" | "prepaid" | "store"`

**billingAddress** `PaymentRequestAddress`

Het afgeschermde factuuradres van de kaart (alleen plaats, staat, postcode en land), dat Apple Pay en Google Pay samen met de kaart doorgeven.

**eigenschappen**

**name** `string`

De naam op het adres.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

> [!WARNING]
>
> Verouderd. Gebruik `name`.

Dezelfde waarde als `name`.

**phone** `string`

**displayName** `string`

Het eigen label van de wallet voor de methode, zoals `Visa 1234`. Apple Pay en Google Pay stellen het pas in zodra de koper autoriseert, dus alleen `paymentAuthorization` bevat het. Toon het en parse het niet: de wallets beloven geen formaat.

**updateWith** `(update: PaymentRequestUpdate) =\> void` *required*

Roep dit precies één keer aan: `amount` en `lineItems` prijzen de sheet opnieuw voor de methode, `updateWith({})` behoudt het totaal en `errors` weigert de methode. Een event dat 10 seconden onbeantwoord blijft, weigert de methode.

**parameters**

**update** `PaymentRequestUpdate` *required*

**eigenschappen**

**amount** `number`

**lineItems** `PaymentRequestLineItem[]`

**eigenschappen**

**label** `string` *required*

**amount** `number` *required*

Kleinste munteenheid, net als `amount`.

**shippingOptions** `PaymentRequestShippingOption[]`

Vervangt de verzendopties van de sheet. De geselecteerde optie blijft geselecteerd zolang de `id` ervan nog in de lijst staat; anders wordt de eerste optie de selectie, zonder `shippingOptionChange`, dus prijs die in hetzelfde antwoord. Een lege lijst verandert niets: weiger een adres waarnaar je niet kunt verzenden in plaats daarvan met een `shipping_address_unserviceable`-fout.

**eigenschappen**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Weergavewaarde in de kleinste munteenheid. De resource berekent geen verzendkosten. Werk `amount` bij vanuit je handler.

**errors** `PaymentRequestError[]`

**eigenschappen**

**code** `string`

Wat een verzendantwoord weigert. Een fout in een antwoord op `billingAddressChange` of `paymentMethodChange` weigert de kaart of methode waar dat event over ging, ongeacht de code.

Een van `"other"`, `"shipping_address_invalid"`, `"shipping_address_unserviceable"` of `"shipping_option_invalid"`.

**message** `string` *required*

**field** `"state" | "country" | "city" | "postal_code"`

Het adresveld waarover de fout gaat: een van de velden van het afgeschermde adres. Apple Pay markeert dat veld met de melding, ongeacht de `code`; Google Pay toont alleen de melding. Laat het weg bij een fout over het hele adres.

### `onPromoCodeChange`

De koper heeft een code getypt, gewijzigd of verwijderd in het promotieveld van de sheet (`requestPromoCode`). Antwoord met `updateWith({ amount })` om de code toe te passen tegen een nieuw totaal, `updateWith({})` om die toe te passen tegen het huidige totaal, of `updateWith({ error })` om die ter plekke te weigeren. Een verwijdering komt binnen met `code` null en wordt op dezelfde manier beantwoord. Het vervangen van een toegepaste code komt binnen als één event met de nieuwe code, nooit eerst een verwijdering, en een geweigerde nieuwe code laat de toegepaste staan. Wanneer `shippingOptions` de geselecteerde optie weglaat, wordt de eerste de selectie zonder een `onShippingOptionChange`, dus prijs die. `appliedDescription` geeft de code een bijschrift in Google Pay; het couponveld van Apple Pay heeft geen bijschrift, dus zet alles wat de koper moet zien in het label van een regelitem. Een handler die een fout gooit, wordt geweigerd of niet binnen 10 seconden antwoordt, weigert de code. Roep `updateWith(…)` precies één keer per event aan. Een handler die een fout gooit of wordt geweigerd voordat hij het aanroept, laat die update meteen mislukken. Retourneert de functie om het abonnement op te zeggen.

**ev** `PromoCodeChangeEvent`

**eigenschappen**

**code** `string | null` *required*

De code die nu in het promotieveld van de sheet staat, of null wanneer de koper die heeft verwijderd. Het vervangen van een toegepaste code is één event met de nieuwe code, nooit eerst een verwijdering.

**updateWith** `(update: PromoCodeUpdate) =\> void` *required*

Antwoord precies één keer: `error` weigert de code en behoudt de totalen, en elk ander antwoord past die toe. `amount` en `lineItems` prijzen de sheet opnieuw onder de code, `shippingOptions` vervangt de verzendopties (een code voor gratis verzending), en `appliedDescription` geeft de toegepaste code een bijschrift waar de sheet er een toont (Google Pay). `updateWith({})` past de code toe tegen het huidige totaal.

**parameters**

**update** `PromoCodeUpdate` *required*

**eigenschappen**

**amount** `number`

Het totaal onder de code, in de kleinste munteenheid.

**lineItems** `PaymentRequestLineItem[]`

De regelitems van de sheet onder de code, zoals de korting en de belasting die erdoor verandert.

**eigenschappen**

**label** `string` *required*

**amount** `number` *required*

Kleinste munteenheid, net als `amount`.

**shippingOptions** `PaymentRequestShippingOption[]`

Vervangt de verzendopties van de sheet onder de code, zoals een code voor gratis verzending die een tarief naar nul brengt. Een optie blijft geselecteerd zolang de `id` ervan nog in de lijst staat; anders wordt de eerste optie de selectie, zonder `shippingOptionChange`. Stuur ook `amount` mee wanneer de prijs van de geselecteerde optie verandert, omdat het totaal niet vanzelf meebeweegt. Een lege lijst verandert niets.

**eigenschappen**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Weergavewaarde in de kleinste munteenheid. De resource berekent geen verzendkosten. Werk `amount` bij vanuit je handler.

**appliedDescription** `string`

Een bijschrift dat naast de toegepaste code wordt getoond in Google Pay. Het couponveld van Apple Pay heeft geen bijschrift, dus zet alles wat de koper moet zien in het label van een regelitem.

**error** `object`

Weigert de code. De sheet toont `message` naast het promotieveld.

**eigenschappen**

**message** `string` *required*

### `onPaymentAuthorization`

De koper heeft de betaling geautoriseerd en er bestaat nog geen bevestigingstoken. Abonneer je om de betaling eerst goed te keuren of te weigeren: de sheet wacht op je antwoord, en zonder handler wordt het token direct aangemaakt. Het event bevat de betaler, de betaalmethode (met het afgeschermde factuuradres, en in `displayName` het eigen label van de wallet ervoor, zoals `Visa 1234`), het verzendadres en de verzendoptie, en het totaal en de regelitems die de koper heeft geautoriseerd. Antwoord met `respondWith({ approved: true })` om het token aan te maken, dat `show()` en `onConfirmationToken` daarna zoals gebruikelijk leveren. Antwoord met `respondWith({ approved: false, message })` om te weigeren: er wordt geen token aangemaakt, Apple Pay en Google Pay tonen `message` in de sheet, en de koper kan iets wijzigen en opnieuw betalen, of de sheet sluiten. PayPal kan je melding niet tonen, dus een weigering daar beëindigt de poging: `show()` wordt geweigerd met `payment_request_refused`, en de koper kan opnieuw op PayPal drukken. Elk event wordt precies één keer beantwoord, en alleen `approved: true` maakt een token aan: een handler die een fout gooit, wordt geweigerd of niet binnen 25 seconden antwoordt, weigert de betaling, vroeg genoeg voor Apple Pay en Google Pay om de weigering te tonen vóór hun eigen limiet van 30 seconden. Roep `respondWith(…)` precies één keer per event aan. Een handler die een fout gooit of wordt geweigerd voordat hij het aanroept, laat die update meteen mislukken. Retourneert de functie om het abonnement op te zeggen.

**ev** `PaymentAuthorizationEvent`

**eigenschappen**

**type** `"apple_pay" | "google_pay" | "paypal_express"` *required*

De wallet waarin de koper heeft geautoriseerd.

**payer** `object` *required*

De betaler, zoals het resultaat die zal bevatten.

**eigenschappen**

**email** `string`

**name** `string`

**phone** `string`

**country** `string`

**paymentMethod** `PaymentRequestPaymentMethod` *required*

De methode die de koper heeft geautoriseerd. Het factuuradres is afgeschermd tot plaats, staat, postcode en land, zoals `paymentMethodChange` het bevat.

**eigenschappen**

**type** `string` *required*

`card` bij Apple Pay en Google Pay, die alleen kaarten melden; `paypal` bij PayPal.

**card** `object`

Wat de wallet over de kaart vertelt. Voordat de koper autoriseert, bij `paymentMethodChange`, meldt Apple Pay het financieringstype, meestal zonder het netwerk, en Google Pay het netwerk. Bij autorisatie melden Apple Pay en Google Pay beide.

**eigenschappen**

**network** `string`

**funding** `"credit" | "debit" | "prepaid" | "store"`

**billingAddress** `PaymentRequestAddress`

Het afgeschermde factuuradres van de kaart (alleen plaats, staat, postcode en land), dat Apple Pay en Google Pay samen met de kaart doorgeven.

**eigenschappen**

**name** `string`

De naam op het adres.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

> [!WARNING]
>
> Verouderd. Gebruik `name`.

Dezelfde waarde als `name`.

**phone** `string`

**displayName** `string`

Het eigen label van de wallet voor de methode, zoals `Visa 1234`. Apple Pay en Google Pay stellen het pas in zodra de koper autoriseert, dus alleen `paymentAuthorization` bevat het. Toon het en parse het niet: de wallets beloven geen formaat.

**shipping** `object | null` *required*

`null` tenzij `requestShipping` is ingesteld. Anders het adres en de optie die het resultaat zal bevatten.

**eigenschappen**

**address** `PaymentRequestAddress`

**eigenschappen**

**name** `string`

De naam op het adres.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

> [!WARNING]
>
> Verouderd. Gebruik `name`.

Dezelfde waarde als `name`.

**phone** `string`

**option** `PaymentRequestShippingOption`

**eigenschappen**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Weergavewaarde in de kleinste munteenheid. De resource berekent geen verzendkosten. Werk `amount` bij vanuit je handler.

**amount** `number` *required*

Het totaal dat de koper heeft geautoriseerd, in de kleinste munteenheid.

**lineItems** `PaymentRequestLineItem[]` *required*

De regelitems die de sheet onder dat totaal toonde.

**eigenschappen**

**label** `string` *required*

**amount** `number` *required*

Kleinste munteenheid, net als `amount`.

**respondWith** `(response: PaymentAuthorizationResponse) =\> void` *required*

Roep dit precies één keer aan. `{ approved: true }` maakt het bevestigingstoken aan. Al het andere weigert de betaling, en er wordt geen token aangemaakt.

**parameters**

**response** `PaymentAuthorizationResponse` *required*

**eigenschappen**

**approved** `boolean` *required*

`true` maakt het bevestigingstoken aan. `false` weigert de betaling.

**message** `string`

Getoond aan de koper wanneer je weigert, in de sheet waarin de autorisatie plaatsvond.

### `onConfirmationToken`

De sheet heeft een bevestigingstoken aangemaakt, ontvangen zodra de sheet is gesloten. Dit is hetzelfde resultaat dat `show()` retourneert. Retourneert de functie om het abonnement op te zeggen.

**ev** `PaymentRequestResult`

**eigenschappen**

**ctok** `string` *required*

ID van het bevestigingstoken, met het voorvoegsel `ctok_`. Bevestig het server-side met je geheime sleutel.

**type** `"apple_pay" | "google_pay" | "paypal_express"` *required*

**payer** `object` *required*

`phone` is E.164 als het kon worden geparset op basis van het land van het contact, en anders zoals opgegeven; PayPal geeft er alleen een bij `requestPayerPhone` en weigert een account zonder telefoonnummer. `country` is het factuurland dat elke sheet verzamelt.

**eigenschappen**

**email** `string`

**name** `string`

**phone** `string`

**country** `string`

**billing** `object | null` *required*

Het volledige factuuradres dat het bevestigingstoken meedraagt, anders dan het afgeschermde adres in de change-events; `null` wanneer de wallet er geen gaf. Apple Pay en Google Pay geven het factuuradres van de kaart. Bij PayPal is het het adres dat de koper in PayPal heeft gekozen, waarover het totaal is belast.

**eigenschappen**

**address** `PaymentRequestAddress` *required*

**eigenschappen**

**name** `string`

De naam op het adres.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

> [!WARNING]
>
> Verouderd. Gebruik `name`.

Dezelfde waarde als `name`.

**phone** `string`

**shipping** `object | null` *required*

`null` tenzij `requestShipping` is ingesteld. `option` is de geselecteerde verzendoptie: de eerst aangeboden optie totdat de koper een andere kiest, en opnieuw de eerste wanneer een antwoord de opties heeft vervangen zonder de gekozen `id`. Apple Pay en Google Pay stellen het in wanneer er opties zijn aangeboden, PayPal nooit.

**eigenschappen**

**address** `PaymentRequestAddress`

**eigenschappen**

**name** `string`

De naam op het adres.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

> [!WARNING]
>
> Verouderd. Gebruik `name`.

Dezelfde waarde als `name`.

**phone** `string`

**option** `PaymentRequestShippingOption`

**eigenschappen**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Weergavewaarde in de kleinste munteenheid. De resource berekent geen verzendkosten. Werk `amount` bij vanuit je handler.

### `onCancel`

De koper heeft de sheet gesloten of PayPal gesloten. Retourneert de functie om het abonnement op te zeggen.

## Content Security Policy

Deze resource wordt uitgevoerd op je pagina, niet in een frame. Een pagina met een Content Security Policy heeft deze bronnen nodig. `contentSecurityPolicy()` uit `@whop/elements` retourneert elke bron in deze tabel. De sandboxbron geldt bij `environment: "sandbox"`.

| Vereiste | Directive | Productiebron | Sandboxbron |
| - | - | - | - |
| Script van Google Pay | `script-src` | `https://pay.google.com` | Hetzelfde |
| ↳ API van Google Pay, die pay.js aanroept | `connect-src` | `https://pay.google.com` | Hetzelfde |
| ↳ Een host die Google vermeldt voor pay.js | `connect-src` | `https://google.com` | Hetzelfde |
| ↳ Een host die Google vermeldt voor pay.js | `connect-src` | `https://account.google.com` | Hetzelfde |
| ↳ Een host die Google vermeldt voor pay.js | `connect-src` | `https://www.google.com` | Hetzelfde |
| Script van Apple Pay | `script-src` | `https://applepay.cdn-apple.com` | Hetzelfde |
| API van Basis Theory, die de betaalgegevens van de wallet tokeniseert | `connect-src` | `https://api.basistheory.com` | Hetzelfde |
| PayPal-script van Braintree | `script-src` | `https://js.braintreegateway.com` | Hetzelfde |
| ↳ GraphQL-API van Braintree, die het script van Braintree aanroept | `connect-src` | `https://payments.braintree-api.com` | `https://payments.sandbox.braintree-api.com` |
| ↳ Client-API van Braintree, die het script van Braintree aanroept | `connect-src` | `https://api.braintreegateway.com` | `https://api.sandbox.braintreegateway.com` |
| ↳ Landingsframe van PayPal, dat het script van Braintree opent | `frame-src` | `https://checkout.paypal.com` | Hetzelfde |
| ↳ Een Braintree-frame, dat het script van Braintree opent | `frame-src` | `https://assets.braintreegateway.com` | Hetzelfde |
| Clientscript van Braintree, dat het PayPal-script van Braintree laadt | `script-src` | `https://assets.braintreegateway.com` | Hetzelfde |
| SDK van PayPal, die het script van Braintree laadt | `script-src` | `https://www.paypal.com` | `https://www.sandbox.paypal.com` |
| ↳ FraudNet-script van PayPal, dat de SDK van PayPal laadt | `script-src` | `https://c.paypal.com` | Hetzelfde |
| ↳ API van PayPal, die de SDK van PayPal aanroept | `connect-src` | `https://api-m.paypal.com` | `https://api-m.sandbox.paypal.com` |
| ↳ Logger van PayPal, die de SDK van PayPal aanroept | `connect-src` | `https://www.paypal.com` | `https://www.sandbox.paypal.com` |
| ↳ Venster van PayPal op de pagina, dat de SDK van PayPal opent | `frame-src` | `https://www.paypal.com` | `https://www.sandbox.paypal.com` |
| ↳ Logo's van PayPal, die de SDK van PayPal toont | `img-src` | `https://www.paypalobjects.com` | Hetzelfde |

Op iOS is dit alleen Apple Pay: Google Pay is een `show(type)`-route voor het web zonder Swift-tegenhanger. Geen element en geen controller: een object dat je zelf aanstuurt, voor een express-checkoutknop boven het formulier. `canMakePayment()` bereidt de sheet voor, en `show()` levert hetzelfde `ctok_` op dat een element aanmaakt. De sheet sluit met een succesvinkje zodra de klant autoriseert; bevestig het token op je server en toon de uitkomst in je app.

## Gebruik

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

struct ExpressCheckout: View {
    @State private var request = WhopPaymentRequest(
        accountID: "biz_xxxx",
        charge: .plan(id: "plan_xxxx")
    )
    @State private var isAvailable = false

    var body: some View {
        VStack {
            if isAvailable {
                WhopApplePayButton {
                    Task { await pay() }
                }
                .frame(height: 48)
            }
        }
        .task { isAvailable = await request.canMakePayment() }
    }

    private func pay() async {
        do {
            let token = try await request.show()
            try await myBackend.confirm(token.id)
        } catch {
            // show the error in your app; the sheet has already closed
        }
    }
}
```

## Parameters

**accountID** `String` *required*

Het account waartoe de afschrijving behoort, met het voorvoegsel `biz_`.

**configuration** `WhopElementsConfiguration`

`environment`, `returnURL` en `locale` werken zoals overal elders. Standaard `WhopElementsConfiguration()`.

**charge** `WhopCharge` *required*

`.plan(id:)` of `.amount(minorUnits:currency:)`. Kan later worden ingesteld; de volgende `canMakePayment()` haalt het opnieuw op.

**setupFutureUsage** `WhopSetupFutureUsage?`

`.offSession` of `.onSession`. Stel dit alleen in nadat je toestemming voor opslaan hebt getoond.

**options** `WhopPaymentRequest.Options`

`requestPayerEmail` en `requestBillingAddress` vragen de sheet om wat je niet hebt aangeleverd (beide standaard `true`), en `label` overschrijft het regelitem dat boven het totaal wordt getoond.

## `WhopConfirmationToken`

Wat een selectie teruggeeft:

* `id: String`: de `ctok_` die server-side moet worden bevestigd
* `paymentMethodType: WhopPaymentMethodType`: `apple_pay` op deze route

## Statussen

`canMakePayment()` retourneert false wanneer het apparaat niet kan betalen, wanneer het account geen geregistreerde Apple Pay-merchant heeft, of wanneer de afschrijving niet kan worden opgehaald; `lastError` vertelt welke. `isPresenting` is true vanaf `show()` totdat die retourneert of een fout gooit, inclusief het aanmaken van het token nadat de sheet is gesloten; een tweede `show()` terwijl er een bezig is, gooit `confirmationInFlight`. `show()` gooit `walletUnavailable` in plaats van geruisloos te mislukken, en de melding maakt onderscheid tussen een koper die de sheet heeft gesloten en een sheet die helemaal niet kon openen; een merchantvalidatie die de API weigert, gooit die API-fout zoals ontvangen.

## Goed om te weten

* `show()` is een gewone async-aanroep, dus je kunt wachten op wat de afschrijving nodig heeft voordat je de sheet toont.
* Combineer het met `WhopApplePayButton`, de eigen `PKPaymentButton` van Apple. De richtlijnen van Apple vereisen het systeembedieningselement in plaats van een getekende imitatie.
* De sheet wordt precies dan om een e-mailadres en factuuradres gevraagd wanneer je die niet hebt aangeleverd, en de antwoorden vullen alleen de gaten.
* De Apple Pay-merchant is degene die op het Whop-account is geregistreerd. Je app levert niets aan en heeft geen `In-App Payments`-capability nodig.

## Installatie

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

> [!NOTE]
>
> `WhopPaymentRequest` heeft geen scope en geen gemount element nodig, dus het is het enige betaaloppervlak waarvoor `WhopBrandingElement` niet op het scherm hoeft te staan. Toon de merchant-of-record-regel zelf. De module is `Elements`, niet `WhopElements` van de wallet-SDK. Zie [Aan de slag](https://docs.whop.com/nl/elements/latest/getting-started.md).
