Brug
Checkout.ApplePayButton til at modtage engangsbetalinger for fysiske varer eller tjenester i den virkelige verden med Apple Pay. Whop behandler betalinger til 2,7 % + $0,30 i stedet for Apples gebyrer på 15–30 % for køb i appen.
Det skal du bygge
- En produktdetaljeskærm med en native Apple Pay-knap
- Et købsforløb, der håndterer succes, fejl og annullering
- Variantkonfiguration i Whop-dashboardet for dine fysiske varer
Forudsætninger
- Installér WhopCheckout-SDK’et
- En API-nøgle afgrænset til
iap:read– se Opret en API-nøgle - Et Whop-produkt med en engangsvariant (se Trin 5)
Trin 1: Konfigurer SDK’et
Initialiser SDK’et ved app-start. Til fysiske engangsvarer har du ikke brug for kompatibilitetsegenskabenplanMappings – den bruges kun til StoreKit-fallback for abonnementer.
Trin 2: Tilføj Apple Pay-knappen
Indsæt Checkout.ApplePayButton i din produktvisning. Komponenten render Apples officielle Apple Pay-knap, der overholder Human Interface Guidelines – du kan ikke erstatte den med en knap med brugerdefineret styling.
onCompletion kaldes ikke, når brugeren annullerer – arket lukkes bare. Ingen oprydning nødvendig.Trin 3: Vælg en knaptekst
Parameterenlabel styrer teksten på knappen. Vælg den, der passer til handlingen:
Den fulde liste kommer fra Apples
PayWithApplePayButtonLabel – se Apples dokumentation for alle muligheder.
Trin 4: Håndter købsresultatet
onCompletion modtager et Result<CheckoutPurchaseResult, Error>. Ved succes får du følgende tilbage:
Brug det til at vise en bekræftelsesskærm, sætte forsendelse i gang eller gemme kvitteringen i dine egne optegnelser.
Trin 5: Opsæt din variant
Hver vare, der kan købes, skal have en variant i dit Whop-dashboard:1
Opret en variant
Gå til dit Dashboard > Products > vælg dit produkt > Variants > Create variant.
2
Sæt den til engangsbetaling
Vælg One-time payment, og angiv prisen.
3
(Valgfrit) Angiv lagergrænser
Til begrænsede drops kan du angive et lagerloft. Checkouten håndhæver det automatisk – når lageret er opbrugt, stopper købene.
4
Kopiér variant-ID'et
ID’et beholder præfikset
plan_. Send det via kompatibilitetsparameteren Checkout.ApplePayButton(planId:).Håndter levering med webhooks
For fysiske varer skal du bruge et webhook på serversiden til at udløse forsendelse efter et vellykket køb. Lyt efter eventenpayment.succeeded:
Callbacket
onCompletion på klientsiden bekræfter betalingen over for brugeren, men din server bør håndtere levering via webhooks – stol ikke på klienten alene. Se den fulde guide om webhooks for opsætning.Komplet eksempel
En minimal detaljevisning for merchandise med valg af størrelse og Apple Pay:Næste trin
Webhooks
Håndter betalingsevents, og udløs levering
Berettigelse til Apple Pay
Bekræft, at din app opfylder kravene i App Store Review Guidelines
Byg en betalingsmur
Sælg abonnementer i stedet for engangskøb
API-reference
Fuld SDK-dokumentation

