Checkout links for app subscriptions: purchase links and redemption links

First finish the four web billing steps: Stripe connected, a web config, web products and an offering that holds them.

1. 01

   Create the link

   In the dashboard open Funnels, then Purchase links, then Create purchase link. Pick the offering and name the link. The slug becomes the end of the address.

2. 02

   Copy the URL

   The address is the pay base, the project slug and the link slug, such as https://api.revenuedot.app/pay/scanner/spring-sale, or your own domain once verified.

3. 03

   Add parameters for known users

   Use Copy link for a signed-in user, or add ?app_user_id=user_123 yourself. The purchase then goes straight to that customer.

4. 04

   Set an expiry or a discount

   Set expires_at to stop the link on a date, or discount_id to apply a web discount to every checkout without a code.

5. 05

   Watch the counters

   Each link counts the checkouts started and the purchases paid.

An expired or turned-off link answers 410 with a page that says the link has expired. The key needs project_configuration:offerings:read_write.

curl -s -X POST "$REVENUEDOT_URL/v2/projects/$PROJECT_ID/purchase_links" \
  -H "Authorization: Bearer $SECRET_KEY" -H "Content-Type: application/json" \
  -d '{"name":"Spring sale","offering_id":"ofrngm2u3h89blc","slug":"spring-sale"}'

A buyer who paid without an app user id gets a deep link such as scanner://redeem_web_purchase?redemption_token=rdrt_... and an https link at /pay/r/<token> for emails and QR codes. Register your URL scheme in the app, then pass the link to the SDK. The link works for 24 hours by default, and only the token's hash is stored.

import RevenueCat
import SwiftUI

struct ContentView: View {
    var body: some View {
        HomeView()
            .onOpenURL { url in
                // Only redemption links parse; other deep links return nil.
                guard let redemption = url.asWebPurchaseRedemption else { return }
                Task {
                    switch await Purchases.shared.redeemWebPurchase(redemption) {
                    case let .success(customerInfo):
                        print("Active:", customerInfo.entitlements.active.keys)
                    case .invalidToken, .purchaseBelongsToOtherUser, .expired, .error:
                        print("Show a message and offer help.")
                    }
                }
            }
    }
}

Redeeming merges the anonymous web buyer into the app user, the same way logIn merges an anonymous customer, and RevenueDot sends one PURCHASE_REDEEMED webhook.