Swift

The Tolt Swift package claims a partner’s code for an app user. Tolt then credits that partner with the purchases RevenueCat reports for the same user. See Mobile apps for how it fits together.

Tolt.claimPOST /client/claims Tolt

Sent by the SDK

claimrequest

app_user_id

code

first_seen_at

In Tolt

customercus_7Lm2…

customer_id

partner

statuslead

Install

Add the package in Xcode under File → Add Package Dependencies, or in Package.swift:

Package.swift

.package(
  url: "https://github.com/toltapp/tolt-swift",
  from: "0.2.0"
)

It supports iOS 15 and macOS 12 and later, and has no dependencies.

Configure

Call configure once at launch with your public key from Settings → Integrations in the dashboard. The SDK remembers the first launch, which the program’s claim window counts from.

App.swift

import Tolt

@main
struct MyApp: App {
  init() {
    Tolt.configure(publicId: "YOUR_PUBLIC_KEY")
  }

  var body: some Scene {
    WindowGroup { ContentView() }
  }
}

Claim a code

Claim the code when the user enters one. Pass the app user id you give RevenueCat.

Swift

let result = try await Tolt.claim(
  code: "SAM20",
  appUserId: Purchases.shared.appUserID
)

Also store the code on the RevenueCat customer. If a purchase reaches Tolt before the claim, Tolt uses it to credit the partner.

Swift

Purchases.shared.attribution.setAttributes(
  Tolt.revenueCatAttributes(code: "SAM20")
)

Claim from a link

When a partner app link opens your app with tolt_click or tolt_code in the URL, pass the URL on. It returns nil for links without either.

Swift

.onOpenURL { url in
  Task {
    _ = try await Tolt.claim(
      url: url,
      appUserId: Purchases.shared.appUserID
    )
  }
}

With a deep linking provider, read the click from its callback instead and call Tolt.claim(clickId:appUserId:).

Results and errors

claim returns a ClaimResult with a status:

`status`	Meaning
`.claimed`	The user is now the partner’s customer
`.alreadyClaimed`	The user already had a partner. Nothing changed

It throws a ToltError:

Error	When
`.notConfigured`	`configure` wasn’t called
`.invalidInput(field)`	The code, click or app user id is empty
`.codeNotFound`	No active partner has this code or click, or the public key is wrong
`.codeConflict(message)`	Two partners share the code, or the claim window has closed
`.rateLimited`	Over 30 claims a minute from one IP
`.server(status:message:)`	Anything else

Overview

Server SDKs

Browser

Mobile

Partner experiences

Tooling and AI

Install

Configure

Claim a code

Claim from a link

Results and errors

​Install

​Configure

​Claim a code

​Claim from a link

​Results and errors

Install

Configure

Claim a code

Claim from a link

Results and errors