# Welcome

#### Monetize Your App with Ease

The Onside Payment SDK (**OnsideKit**) lets you integrate in-app purchases and subscriptions into your iOS app. It handles the entire payment flow — from product display to checkout — providing a secure experience for your users while keeping integration simple.

Currently supported payment methods: **Apple Pay** and **bank cards**. See [Managing Payment Methods](/sdk/purchasing/payment-methods.md) and [Apple Pay](/sdk/purchasing/apple-pay.md).

{% hint style="info" %}
**New to OnsideKit?** Start with the [Quick Start](/sdk/getting-started/quick-start.md) for a minimal, end-to-end integration you can copy-paste, then come back here for the full guides.
{% endhint %}

#### Get Started

Follow these steps to integrate OnsideKit into your app:

<table><thead><tr><th width="80">Step</th><th width="280">Guide</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td><a href="/pages/fE4i5CW7M0ZeaZqcsDJp">Installation</a></td><td>Add OnsideKit to your project via Swift Package Manager, CocoaPods, or a manual framework install.</td></tr><tr><td>2</td><td><a href="/pages/p3ct9vTDKLqewcHrq3SF">Initializing the SDK</a></td><td>Initialize OnsideKit, register your callback URL scheme, and forward incoming URLs for app-to-app login.</td></tr><tr><td>3</td><td><a href="/pages/IDqAGYlWbxSmIjHh88J7">Authentication &#x26; User Account</a></td><td>Understand the login flows — explicit, implicit (on-demand), and session management.</td></tr><tr><td>4</td><td><a href="/pages/c1zXVakY1NYA1etwIIJj">Fetching Products</a></td><td>Fetch your product catalog, handle regional pricing, and display offerings to users.</td></tr><tr><td>5</td><td><a href="/pages/HhnXQpRNBjCAhuOmnFSN">Making a Purchase</a></td><td>Initiate purchases, process transactions, restore previous purchases, and validate on your backend.</td></tr></tbody></table>

#### Requirements

* **iOS 16.0** or later
* **Xcode 26** or later
* Distributed as a binary `xcframework` via **Swift Package Manager** and **CocoaPods** — see the [Installation](/sdk/getting-started/installation.md) guide.

{% hint style="info" %}
OnsideKit ships in two flavors: **OnsideKit** (the full SDK, with Apple Pay) and **OnsideKitLite** (the same SDK without the PassKit dependency, for apps that cannot include PassKit — Apple Pay is unavailable there). See [OnsideKit vs OnsideKitLite](/sdk/advanced-and-tooling/onsidekit-lite.md).
{% endhint %}

#### Designed for a Seamless Transition

OnsideKit is intentionally **modeled on Apple's native StoreKit framework**. If your team has experience with StoreKit, integration will feel familiar — the same delegate patterns, a similar queue-based transaction flow, and comparable product-request APIs. See [Migrating from StoreKit](/sdk/reference/migrating-from-storekit.md) for a side-by-side mapping.

#### Key Features

* **Familiar & easy integration:** StoreKit-inspired API for a minimal learning curve.
* **Purchases & subscriptions:** one unified flow for consumables, non-consumables, and auto-renewable subscriptions.
* **Apple Pay & bank cards:** Apple Pay (full OnsideKit build) plus a built-in card-management UI.
* **Clear responses & error handling:** informative value types and a unified set of typed errors — see the [Error Reference](/sdk/reference/errors.md).
* **Native, web & Unity:** a native Swift API, a [JavaScript bridge](/sdk/integrations/js-bridge.md) for `WKWebView`-based apps, and a [Unity package](/sdk/integrations/unity.md).
* **Test without a backend:** develop and QA the purchase flow offline with [Local Testing](/sdk/advanced-and-tooling/local-testing.md) and a `.storekit` file.

***

#### What You Can Do Now

You can start setting up your monetization strategy in the [Onside Developer Console](https://developer.onside.io) right away:

* Set up in-app purchases
* [Configure subscriptions](/sdk/products-and-subscriptions/subscriptions.md)

#### Related topics

These are the next docs most teams need after the core integration:

* [The Onside Delegate](/sdk/customization/delegate.md) — theming, host window scene, login routing, and region hints
* [Attribution](/sdk/attribution-and-analytics/attribution.md) — install-attribution metadata
* [Building funnels with event tracking](/sdk/attribution-and-analytics/building-funnels-with-event-tracking.md) — track actions with `Onside.track`
* [Purchase Validation](/sdk/purchase-validation/purchase-validation.md) — server-side verification with the Merchant API
* [OnsideKit Example App](/sdk/reference/example-app.md) — a working reference project

#### Need More Help?

| Resource              | Description                                        | Link                                                                            |
| --------------------- | -------------------------------------------------- | ------------------------------------------------------------------------------- |
| Monetization Overview | All monetization options available on Onside       | [Go to Monetization Overview](/console/monetization/overview-and-commission.md) |
| Contact Support       | Questions about the SDK? Our team is here to help. | [Email Us](mailto:support@onside.io)                                            |
| Main Help Section     | Common questions about developing for Onside       | [Visit Help Section](https://docs.onside.io/console/)                           |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onside.io/sdk/getting-started/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.