Skip to main content
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.
Til salg på nettet kan du bruge checkout-links eller Checkout-elementet med over 100 betalingsmetoder i 195 lande.
Apple Pay er ikke til digitalt indhold. Brug kun Checkout.ApplePayButton, hvis din app sælger fysiske varer (merchandise, mad, hardware) eller tjenester i den virkelige verden (billetter til events, leveringer). Apps, der sælger digitalt indhold – premiumfunktioner, abonnementer, valuta i appen, oplåsning af indhold – skal bruge StoreKit. Se afsnittet Berettigelse til Apple Pay for detaljer.

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

Trin 1: Konfigurer SDK’et

Initialiser SDK’et ved app-start. Til fysiske engangsvarer har du ikke brug for kompatibilitetsegenskaben planMappings – den bruges kun til StoreKit-fallback for abonnementer.
Se installationsguiden for den fulde opsætning og sikkerhedsnoter om API-nøglen.

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.
Når brugeren trykker, får vedkommende det native Apple Pay-ark. Face ID eller dobbeltklik bekræfter, og betalingen går gennem Whop.
onCompletion kaldes ikke, når brugeren annullerer – arket lukkes bare. Ingen oprydning nødvendig.

Trin 3: Vælg en knaptekst

Parameteren label 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 eventen payment.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