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.
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
- Installeer de WhopCheckout-SDK
- Een API-sleutel afgebakend tot
iap:read: zie Een API-sleutel aanmaken - Een Whop-product met een eenmalige variant (zie Stap 5)
Stap 1: de SDK configureren
Initialiseer de SDK bij het starten van de app. Voor eenmalige fysieke goederen heb je de compatibiliteitseigenschapplanMappings niet nodig; die wordt alleen gebruikt voor de StoreKit-fallback bij abonnementen.
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.
onCompletion wordt niet aangeroepen wanneer de gebruiker annuleert; het venster sluit gewoon. Opruimen is niet nodig.Stap 3: een knoplabel kiezen
De parameterlabel 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 eventpayment.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

