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

# Modtag engangsbetalinger

> Modtag Apple Pay-engangsbetalinger for fysiske varer og tjenester i den virkelige verden i din iOS-app.

[Modtag engangsbetalinger på iOS med Whop](https://www.youtube.com/embed/K2e_sht1P1I?rel=0)

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.

> [!TIP]
>
> Til salg på nettet kan du bruge [checkout-links eller Checkout-elementet](https://docs.whop.com/da/developer/guides/accept-payments.md) med **over 100 betalingsmetoder** i **195 lande**.

> [!WARNING]
>
> **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](https://docs.whop.com/da/developer/guides/ios/checkout-reference.md#apple-pay-eligibility) 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

* [Installér WhopCheckout-SDK'et](https://docs.whop.com/da/developer/guides/ios/installation.md)
* En API-nøgle afgrænset til `iap:read` – se [Opret en API-nøgle](https://docs.whop.com/da/developer/guides/ios/installation.md#step-3-create-an-api-key)
* Et Whop-produkt med en engangsvariant (se [Trin 5](#step-5-set-up-your-variant))

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

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

@main
struct DropsApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(Checkout.shared)
                .task {
                    try? await Checkout.shared.configure(
                        // companyId: find in Dashboard URL (starts with biz_)
                        companyId: "biz_xxxxxxxxxxxxxx",
                        // apiKey: create in Dashboard > Developer with iap:read permission
                        apiKey: "your_api_key_here"
                    )
                }
        }
    }
}
```

Se [installationsguiden](https://docs.whop.com/da/developer/guides/ios/installation.md) 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.

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

struct ProductDetailView: View {
    let product: MerchItem
    @State private var purchaseComplete = false

    var body: some View {
        ScrollView {
            // product image, title, price, size picker...

            Checkout.ApplePayButton(
                // planId: find in Dashboard > Products > [product] > Variants
                planId: product.planId,
                label: .buy,
                onCompletion: { result in
                    switch result {
                    case .success(let purchase):
                        // purchase.receiptId, purchase.membership
                        purchaseComplete = true
                    case .failure(let error):
                        print("Purchase failed: \(error.localizedDescription)")
                    }
                }
            )
            .frame(height: 48)
            .padding(.horizontal)
        }
    }
}
```

Når brugeren trykker, får vedkommende det native Apple Pay-ark. Face ID eller dobbeltklik bekræfter, og betalingen går gennem Whop.

> [!NOTE]
>
> `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:

| Label | Knaptekst | Bruges til |
| - | - | - |
| `.buy` | Buy with Apple Pay | Engangsmerchandise og fysiske varer |
| `.checkout` | Check out with… | Checkout-forløb i indkøbskurvsstil |
| `.order` | Order with Apple Pay | Mad, leveringer, varer lavet på bestilling |
| `.book` | Book with Apple Pay | Reservationer, aftaler, events |
| `.continue` | Continue with… | Forløb i flere trin, hvor dette ikke er det sidste |
| `.plain` | (Apple Pay-logo) | Fallback, når intet udsagnsord passer |

Den fulde liste kommer fra Apples `PayWithApplePayButtonLabel` – se [Apples dokumentation](https://developer.apple.com/documentation/passkit/paywithapplepaybuttonlabel) for alle muligheder.

## Trin 4: Håndter købsresultatet

`onCompletion` modtager et `Result<CheckoutPurchaseResult, Error>`. Ved succes får du følgende tilbage:

| Egenskab | Type | Beskrivelse |
| - | - | - |
| `receiptId` | `String` | Unikt kvitterings-ID for dette køb |
| `membership` | `CheckoutMembership?` | Det medlemskab, Whop oprettede for købet |

Brug det til at vise en bekræftelsesskærm, sætte forsendelse i gang eller gemme kvitteringen i dine egne optegnelser.

```swift theme={null}
onCompletion: { result in
    switch result {
    case .success(let purchase):
        // Persist the receipt for your fulfillment flow
        OrderStore.shared.record(
            receiptId: purchase.receiptId,
            membershipId: purchase.membership?.id,
            product: product
        )
        showConfirmation = true
    case .failure(let error):
        showError(error.localizedDescription)
    }
}
```

## 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](https://whop.com/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`:

```typescript theme={null}
import { unwrapWebhook } from "@whop/sdk/helpers";

export async function POST(request: Request) {
  const body = await request.text();
  const headers = Object.fromEntries(request.headers);
  const event = unwrapWebhook(body, { headers, key: process.env.WHOP_WEBHOOK_SECRET });

  if (event.type === "payment.succeeded") {
    // Trigger your shipping/fulfillment flow
    await fulfillOrder(event.data);
  }

  return new Response("OK", { status: 200 });
}
```

> [!NOTE]
>
> 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](https://docs.whop.com/da/developer/guides/webhooks.md) for opsætning.

## Komplet eksempel

En minimal detaljevisning for merchandise med valg af størrelse og Apple Pay:

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

struct ProductDetailView: View {
    let product: MerchItem
    @State private var selectedSize: String?
    @State private var showConfirmation = false

    var body: some View {
        ScrollView {
            VStack(alignment: .leading, spacing: 16) {
                AsyncImage(url: product.imageURL) { image in
                    image.resizable().scaledToFit()
                } placeholder: {
                    Color.gray.opacity(0.1)
                }
                .frame(maxWidth: .infinity)

                Text(product.title)
                    .font(.title)
                    .bold()

                Text(product.price, format: .currency(code: "USD"))
                    .font(.title2)

                // Size picker
                HStack {
                    ForEach(product.sizes, id: \.self) { size in
                        Button(size) {
                            selectedSize = size
                        }
                        .buttonStyle(.bordered)
                        .tint(selectedSize == size ? .accentColor : .secondary)
                    }
                }

                Checkout.ApplePayButton(
                    planId: product.planId,
                    label: .buy,
                    onCompletion: { result in
                        switch result {
                        case .success(let purchase):
                            print("Receipt: \(purchase.receiptId)")
                            showConfirmation = true
                        case .failure(let error):
                            print("Purchase failed: \(error.localizedDescription)")
                        }
                    }
                )
                .frame(height: 48)
                .disabled(selectedSize == nil)
            }
            .padding()
        }
        .sheet(isPresented: $showConfirmation) {
            OrderConfirmationView(product: product, size: selectedSize ?? "")
        }
    }
}
```

## Næste trin

> [card] [Webhooks](https://docs.whop.com/da/developer/guides/webhooks.md)
>
> Håndter betalingsevents, og udløs levering

> [card] [Berettigelse til Apple Pay](https://docs.whop.com/da/developer/guides/ios/checkout-reference.md#apple-pay-eligibility)
>
> Bekræft, at din app opfylder kravene i App Store Review Guidelines

> [card] [Byg en betalingsmur](https://docs.whop.com/da/developer/guides/ios/build-a-paywall.md)
>
> Sælg abonnementer i stedet for engangskøb

> [card] [API-reference](https://docs.whop.com/da/developer/guides/ios/checkout-reference.md)
>
> Fuld SDK-dokumentation


## Related topics

- [Modtag betalinger](https://docs.whop.com/da/developer/guides/accept-payments.md)
- [Oversigt over betalinger](https://docs.whop.com/da/developer/payments/overview.md)
- [Byg Whop-apps med React Native](https://docs.whop.com/da/developer/guides/react-native.md)
