For the complete documentation index, see llms.txt. This page is also available as Markdown.

OnsideKit vs OnsideKitLite

OnsideKitLite is the SDK without the PassKit dependency (no Apple Pay), for apps that cannot include PassKit.

OnsideKit ships as two products, built from the same source:

Product
Apple Pay / PassKit
Use it when

OnsideKit

Included

The default. Use it unless you have a reason not to.

OnsideKitLite

Excluded

Your app cannot include the PassKit framework.

The two are identical apart from Apple Pay. Bank-card payments, login, products, the payment queue, attribution, event tracking, and the JS bridge are all present in both.

What changes in Lite

  • No Apple Pay. The purchase and payment-methods UI offer bank cards only — the Apple Pay option never appears.

  • No applePayMerchantIdentifier. This API exists only in the full build. Referencing Onside.applePayMerchantIdentifier in an app that links OnsideKitLite is a compile error.

Everything else — the Onside API, models, delegates, and observers — is the same.

Choosing and importing

The capability is fixed by which product you add as a dependency; there is no runtime or compile flag in your app. Add OnsideKit or OnsideKitLite as described in Installation, then import the matching module:

import OnsideKit        // full build
// or
import OnsideKitLite    // no PassKit / no Apple Pay

In both cases you use the same Onside API (minus applePayMerchantIdentifier in Lite).

If you need Apple Pay later, switch the dependency to the full OnsideKit product and configure it as described in Apple Pay.

Last updated

Was this helpful?