Skip to main content
Gebruik Checkout.ApplePayButton om met Apple Pay eenmalige betalingen te accepteren voor fysieke goederen of diensten in de echte wereld. Whop verwerkt betalingen tegen 2,7% + $0,30 in plaats van de in-app-aankoopkosten van 15–30% bij Apple.
Gebruik voor verkoop op het web checkoutlinks of het Checkout-element voor meer dan 100 betaalmethoden in 195 landen.
Apple Pay is niet bedoeld voor digitale content. Gebruik Checkout.ApplePayButton alleen als je app fysieke goederen (merchandise, eten, hardware) of diensten in de echte wereld (evenementtickets, bezorgingen) verkoopt. Apps die digitale content verkopen, zoals premiumfuncties, abonnementen, in-app-valuta of het ontgrendelen van content, moeten StoreKit gebruiken. Zie de sectie Geschiktheid voor Apple Pay voor details.

Wat je gaat bouwen

  • Een productdetailscherm met een native Apple Pay-knop
  • Een aankoopflow die succes, mislukking en annulering afhandelt
  • Variantconfiguratie in het Whop-dashboard voor je fysieke goederen

Vereisten

Stap 1: de SDK configureren

Initialiseer de SDK bij het starten van de app. Voor eenmalige fysieke goederen heb je de compatibiliteitseigenschap planMappings niet nodig; die wordt alleen gebruikt voor de StoreKit-fallback bij abonnementen.
Zie de installatiegids voor de volledige installatie en beveiligingsopmerkingen over de API-sleutel.

Stap 2: de Apple Pay-knop toevoegen

Plaats Checkout.ApplePayButton in je productweergave. De component rendert de officiële Apple Pay-knop van Apple die voldoet aan de Human Interface Guidelines; je kunt deze niet vervangen door een knop met een aangepaste stijl.
Wanneer de gebruiker tikt, verschijnt het native Apple Pay-venster. Face ID of dubbelklikken bevestigt de betaling, en de betaling loopt via Whop.
onCompletion wordt niet aangeroepen wanneer de gebruiker annuleert; het venster sluit gewoon. Opruimen is niet nodig.

Stap 3: een knoplabel kiezen

De parameter label bepaalt de tekst op de knop. Kies het label dat bij de actie past: De volledige lijst komt uit PayWithApplePayButtonLabel van Apple; zie de documentatie van Apple voor elke optie.

Stap 4: het aankoopresultaat afhandelen

onCompletion ontvangt een Result<CheckoutPurchaseResult, Error>. Bij succes krijg je terug: Gebruik dit om een bevestigingsscherm te tonen, de verzending te starten of de bon op te slaan voor je eigen administratie.

Stap 5: je variant instellen

Elk koopbaar item heeft een variant in je Whop-dashboard nodig:
1

Maak een variant aan

Ga naar je dashboard > Products > selecteer je product > Variants > Create variant.
2

Stel deze in op eenmalig

Kies One-time payment en stel de prijs in.
3

(Optioneel) Stel voorraadlimieten in

Stel voor beperkte drops een voorraadlimiet in. De checkout dwingt deze automatisch af: wanneer de voorraad op is, stoppen de aankopen.
4

Kopieer het variant-ID

Het ID behoudt het voorvoegsel plan_. Geef het door via de compatibiliteitsparameter Checkout.ApplePayButton(planId:).

Uitlevering afhandelen met webhooks

Voor fysieke goederen heb je een webhook aan de serverzijde nodig om de verzending te starten na een geslaagde aankoop. Luister naar het event payment.succeeded:
De callback onCompletion aan de clientzijde bevestigt de betaling aan de gebruiker, maar je server moet de uitlevering via webhooks afhandelen; vertrouw niet alleen op de client. Zie de volledige webhooksgids voor de instelling.

Compleet voorbeeld

Een minimale detailweergave voor merchandise met maatkeuze en Apple Pay:

Volgende stappen

Webhooks

Verwerk betalingsevents en start de uitlevering

Geschiktheid voor Apple Pay

Controleer of je app voldoet aan de App Store Review Guidelines

Een paywall bouwen

Verkoop abonnementen in plaats van eenmalige aankopen

API-referentie

Volledige SDK-documentatie