# Onside ## Home - [Onside Documentation](https://docs.onside.io/onside-documentation.md): Learn in detail about the console, tools, and technologies in Onside ## Onside Store - [Welcome to Onside Store: Alternative iOS App Store for the EU and Japan](https://docs.onside.io/store/about.md): A quick introduction to the Onside Store, its key benefits, what you can find inside, and our commitment to your safety. - [How to Install Onside Store](https://docs.onside.io/store/getting-started/how-to-install-onside-store.md): The installation won’t take long—you’ll be using the app marketplace within minutes. - [Troubleshooting Installation Issues](https://docs.onside.io/store/getting-started/how-to-install-onside-store/troubleshooting-installation-issues.md): Fix Onside Store install problems on iOS: resolve region and device requirements, profiles/permissions, storage, network, and update errors. Includes quick checks, error codes, and support steps. - [How to Update Onside Store](https://docs.onside.io/store/getting-started/how-to-update-onside-store.md): Keeping your Onside Store app up-to-date is important for the latest features, security, and the best experience. Here’s how to manage updates for the Onside marketplace app itself. - [Notifications](https://docs.onside.io/store/getting-started/notifications.md): Stay up-to-date with your apps! This page explains how to manage notifications from Onside Store. - [Can I Trust Onside?](https://docs.onside.io/store/authorization-and-safety/can-i-trust-onside.md): A guide to understanding Onside's commitment to security, how we ensure apps are safe, and the best practices for using our marketplace securely. - [How to Sign Up?](https://docs.onside.io/store/authorization-and-safety/how-to-sign-up.md): Create an Onside account with your phone number to manage purchases, your profile, and other account-based features. - [How to Log Out?](https://docs.onside.io/store/authorization-and-safety/how-to-log-out.md): Log out of the Onside Store safely: find the logout option, end sessions on iOS, switch accounts, and troubleshoot issues (missing button, lost device, session not closing). - [How to Delete Your Account?](https://docs.onside.io/store/authorization-and-safety/how-to-delete-your-account.md): If you wish to permanently delete your Onside Store account and its associated data, please follow these steps. - [Main Sections](https://docs.onside.io/store/onside-app-interface/main-sections.md): Understanding the Onside App Interface - [App Page](https://docs.onside.io/store/onside-app-interface/app-page.md): A detailed guide to all the sections and features you'll find on an app or game's product page in the Onside Store. - [Changing the App Theme](https://docs.onside.io/store/onside-app-interface/changing-the-app-theme.md): Onside Store is designed to look great on your iPhone, and we offer different appearance options to suit your preference. - [Updating Apps in Onside](https://docs.onside.io/store/app-management/updating-apps-in-onside.md): Learn how to update apps in Onside: check for new versions, enable auto-updates in settings, troubleshoot failed updates, and manage rollbacks. - [Troubleshooting App Updates](https://docs.onside.io/store/app-management/troubleshooting-app-updates.md): Find solutions for Onside app update issues: enable auto-updates, fix storage or network problems, restart the app or iPhone, and resolve stuck or failed installs. - [Payment Methods & Currencies](https://docs.onside.io/store/purchases-and-returns/payment-methods-and-currencies.md): An overview of the payment methods and currencies currently supported by Onside for all purchases. - [Linking a Bank Card to Onside](https://docs.onside.io/store/purchases-and-returns/linking-a-bank-card-to-onside.md): Link your bank card to your Onside account for fast and easy purchases of apps, in-app items, and subscriptions. - [Purchasing Paid Apps](https://docs.onside.io/store/purchasing-paid-apps.md): A guide on how to purchase apps with a one-time cost in the Onside Store, including information on refunds and re-downloading. - [Troubleshooting Payment Issues](https://docs.onside.io/store/troubleshooting-payment-issues.md): A guide to resolving common payment problems, from declined transactions to refund requests and questions about currencies. - [Keeping Your iPhone Secure](https://docs.onside.io/store/onside-rules-and-policies/keeping-your-iphone-secure.md): Learn the essential security practices for your iPhone and understand Onside's commitment to creating a safe marketplace. - [Participate in UX Research (Users)](https://docs.onside.io/store/onside-rules-and-policies/participate-in-ux-research-users.md): An invitation for Onside Store users to participate in feedback sessions and help us build an even better app marketplace. - [Data Collection Policy](https://docs.onside.io/store/onside-rules-and-policies-japan/data-collection-policy.md): How Onside collects, uses, protects, and handles personal information in Japan, including user rights under APPI, cross-border data handling, and contact details for privacy requests. - [App Marketplace Guidelines](https://docs.onside.io/store/onside-rules-and-policies-japan/app-marketplace-guidelines.md): Rules for distributing apps through Onside in Japan, including legal compliance, intellectual property, fraud prevention, quality standards, and the review and appeals process. - [Intellectual Property Review Mechanism For App Distribution](https://docs.onside.io/store/onside-rules-and-policies-japan/intellectual-property-review-mechanism-for-app-distribution.md): How Onside reviews apps for intellectual property compliance in Japan before distribution, including submission requirements, manual screening, developer remediation, and ongoing enforcement. - [Intellectual Property Dispute Resolution Policy](https://docs.onside.io/store/onside-rules-and-policies-japan/intellectual-property-dispute-resolution-policy.md): How Onside handles intellectual property disputes in Japan, including notice requirements, review steps, developer responses, content removal, and repeat infringement enforcement. - [Governmental And Legal Compliance Policy For App Takedown Requests](https://docs.onside.io/store/onside-rules-and-policies-japan/governmental-and-legal-compliance-policy-for-app-takedown-requests.md): How Onside handles governmental, legal, intellectual property, and policy-based app takedown requests in Japan, including review steps, temporary restrictions, developer notices, and contact details. - [Data Collection Policy](https://docs.onside.io/store/onside-rules-and-policies-brazil/data-collection-policy.md): How Onside collects, uses, protects, and processes personal information in Brazil, including user rights under LGPD and information about international data transfers and privacy requests. - [App Marketplace Guidelines](https://docs.onside.io/store/onside-rules-and-policies-brazil/app-marketplace-guidelines.md): Rules for distributing apps through Onside in Brazil, including legal compliance, safety requirements, quality standards, and app review procedures. - [Intellectual Property Review Mechanism For App Distribution](https://docs.onside.io/store/onside-rules-and-policies-brazil/intellectual-property-review-mechanism-for-app-distribution.md): How Onside reviews apps for intellectual property compliance before and after distribution in Brazil. - [Intellectual Property Dispute Resolution Policy](https://docs.onside.io/store/onside-rules-and-policies-brazil/intellectual-property-dispute-resolution-policy.md): Process for reporting, reviewing, and resolving intellectual property disputes related to apps distributed through Onside in Brazil. - [Governmental And Legal Compliance Policy For App Takedown Requests](https://docs.onside.io/store/onside-rules-and-policies-brazil/governmental-and-legal-compliance-policy-for-app-takedown-requests.md): Process for handling governmental, legal, intellectual property, and policy-based app takedown requests on Onside in Brazil. ## Onside Console - [Welcome to Onside Console](https://docs.onside.io/console/readme.md): An introduction to the Onside Developer Console, outlining its main features and guiding you to your first steps on the platform. - [Create Onside Account](https://docs.onside.io/console/getting-started-and-publishing/create-onside-account.md): A step-by-step guide to creating your Onside developer account, choosing your account type, and connecting it to the App Store for seamless app management. - [Link Apple Developer Account to Onside](https://docs.onside.io/console/getting-started-and-publishing/link-apple-developer-account-to-onside.md): A step-by-step guide to connecting your AppStore Connect account to Onside using an API Key and Marketplace Token for seamless app management. - [How to Publish an App](https://docs.onside.io/console/publishing-your-app/how-to-publish-an-app.md): A comprehensive guide on how to publish your app on Onside, explaining the two review paths: the standard App Store Review and the Onside-only Notarization. - [App Requirements & Guidelines](https://docs.onside.io/console/publish-your-docs.md): A practical guide to the Onside App Guidelines, our commitment to safety and quality, and how to prepare your app for a smooth review process. - [Wrap your Site as App](https://docs.onside.io/console/wrap-your-site-as-app.md): Learn how Onside can turn your existing Progressive Web App (PWA) or website into a native iOS app for distribution on our marketplace. - [Edit Your App Metadata](https://docs.onside.io/console/account-and-platform/edit-your-app-metadata.md): A guide to managing your app's store listing information on Onside, including syncing with the App Store and making manual edits for instant updates. - [Managing User Access and Roles](https://docs.onside.io/console/account-and-platform/managing-user-access-and-roles.md): Manage user access in Onside: invite team members, assign roles and permissions, set organization ownership, and revoke access—all from the Developer Console. - [Onside Legal Documents](https://docs.onside.io/console/account-and-platform/onside-legal-documents.md): Access Onside’s legal documents: Terms of Use, Privacy Policy, Developer Agreement, Data Processing, and compliance policies—latest versions and change history. - [Overview & Commission](https://docs.onside.io/console/monetization/overview-and-commission.md): An introduction to Onside's monetization framework, starting with your choice of payment processing, and then detailing our commission and tax policies. - [Using a Third-Party Payment Provider](https://docs.onside.io/console/monetization/using-a-third-party-payment-provider.md): A guide for developers who choose to use their own payment infrastructure and need to report transactions to Onside. - [Paid Apps](https://docs.onside.io/console/monetization/paid-apps.md): Configure and manage in-app products in Onside. Set pricing, regions, and billing options for iOS apps directly from the Developer Console. - [In-App Purchases](https://docs.onside.io/console/monetization/in-app-purchases.md): Configure and manage in-app purchases in Onside: set consumables, non-consumables, entitlement logic, product bundles, and pricing across regions using the Developer Console. - [Monetization FAQ](https://docs.onside.io/console/monetization/faq.md): Frequently asked questions about Onside monetization: commissions, app pricing, in-app products, subscriptions, payment flow, refunds, and policy clarifications. - [ASO & Discovery Tips](https://docs.onside.io/console/marketing-and-promotion/aso-and-discovery-tips.md): Learn how to optimize your app's product page for better visibility, more downloads, and greater success on the Onside Store. - ["Download from Onside" Button for Your Website](https://docs.onside.io/console/marketing-and-promotion/download-from-onside-button-for-your-website.md): Include Onside badge on your website as a clear call to action to get your app - [Grow with Onside](https://docs.onside.io/console/marketing-and-promotion/grow-with-onside.md): Onside helps publishers grow through Web2App distribution, running and optimizing campaigns across Google Ads and Meta Ads — from setup to scale. - [Landing Page Asset Requirements](https://docs.onside.io/console/marketing-and-promotion/landing-page-asset-requirements.md): What to send Onside when we create a distribution landing page for your app. - [Participate in UX Research (Developers)](https://docs.onside.io/console/participate-in-ux-research-developers.md): An invitation for Onside developers to participate in UX research interviews to help shape the future of our platform. ## Onside SDK - [Welcome](https://docs.onside.io/sdk/getting-started/readme.md): An overview of the Onside Payment SDK, designed for easy integration to help you monetize your apps with in-app purchases and subscriptions. - [Quick Start](https://docs.onside.io/sdk/getting-started/quick-start.md): A minimal, end-to-end OnsideKit integration you can copy-paste: initialize the SDK, fetch a product, buy it, and finish the transaction. - [Installation](https://docs.onside.io/sdk/getting-started/installation.md): Add the OnsideKit framework to your iOS project with Swift Package Manager, CocoaPods, or a manual framework install. - [Initializing the SDK](https://docs.onside.io/sdk/getting-started/initialization.md): Initialize OnsideKit, register your callback URL scheme, and forward incoming URLs so the app-to-app login flow can complete. - [Authentication & User Account](https://docs.onside.io/sdk/core-concepts/authentication.md): How OnsideKit handles authentication: explicit and on-demand login, the two login flows, reading session state, and logging out. - [The Payment Queue & Transactions](https://docs.onside.io/sdk/core-concepts/payment-queue.md): How the OnsidePaymentQueue processes transactions, why a transaction observer is required, the transaction lifecycle, and why finishing transactions is mandatory. - [Threading & Object Lifetime](https://docs.onside.io/sdk/core-concepts/threading-and-retention.md): OnsideKit's main-actor threading model and the lifetime rules for request objects, observers, and delegates. - [Fetching Products](https://docs.onside.io/sdk/products-and-subscriptions/fetching-products.md): Fetch your product catalog from Onside with a products request, read product details, and handle errors. - [Subscriptions](https://docs.onside.io/sdk/products-and-subscriptions/subscriptions.md): Work with auto-renewable subscriptions in OnsideKit: detect them, read the billing period, then purchase, restore, and validate them like any other product. - [Regions & Storefronts](https://docs.onside.io/sdk/products-and-subscriptions/regions-and-storefronts.md): How OnsideKit resolves the user's region and storefront before and after login, and how that affects product availability and pricing. - [Making a Purchase](https://docs.onside.io/sdk/purchasing/making-a-purchase.md): Start a purchase by adding a payment to the queue, process the resulting transaction, and finish it. - [Restoring Purchases](https://docs.onside.io/sdk/purchasing/restoring-purchases.md): Let users restore their previous non-consumable and subscription purchases on a new device or after reinstalling. - [Handling Storefront & Price Changes](https://docs.onside.io/sdk/purchasing/storefront-price-changes.md): Approve or cancel a queued purchase when the storefront or price changes between enqueue and execution, using OnsidePaymentQueueDelegate. - [Managing Payment Methods](https://docs.onside.io/sdk/purchasing/payment-methods.md): Let users manage their saved payment methods (bank cards) with OnsideKit's built-in payment methods manager screen. - [Apple Pay](https://docs.onside.io/sdk/purchasing/apple-pay.md): Set up Apple Pay in OnsideKit using a Merchant ID, an Apple-generated certificate, and your app's Apple Pay capability. - [Overview](https://docs.onside.io/sdk/purchase-validation/purchase-validation.md): Validate purchases server-side: obtain a signed transaction history on the client and verify it against the Onside Merchant API. - [Signed In-App Purchase History](https://docs.onside.io/sdk/purchase-validation/signed-in-apps-history.md): Download a signed (JWS) in-app purchase history on the client using makeSignedInAppsHistoryRequest(). - [Backend Validation & Merchant API](https://docs.onside.io/sdk/purchase-validation/merchant-api.md): Authenticate to the Onside Merchant API and validate transactions from your own backend. - [Merchant API](https://docs.onside.io/sdk/purchase-validation/merchant-api/merchant-api.md) - [Models](https://docs.onside.io/sdk/purchase-validation/merchant-api/models.md) - [The Onside Delegate](https://docs.onside.io/sdk/customization/delegate.md): Customize OnsideKit with OnsideDelegate — host window scene, per-screen theme override, login routing, and a pre-login region hint. - [Appearance & Theming](https://docs.onside.io/sdk/customization/appearance.md): Apply a consistent global theme to all screens presented by OnsideKit using OnsideAppearance. - [Attribution](https://docs.onside.io/sdk/attribution-and-analytics/attribution.md): Retrieve install attribution metadata from OnsideKit, including the referring browser URL tied to a prior web session. - [Building funnels with event tracking](https://docs.onside.io/sdk/attribution-and-analytics/building-funnels-with-event-tracking.md): Track user actions with Onside.track and build funnels over these events. - [JS ↔ Native Bridge](https://docs.onside.io/sdk/integrations/js-bridge.md): Use the Onside JS Bridge to call OnsideKit from JavaScript in a \`WKWebView\`. Covers setup, \`window.onside\` APIs, callbacks, transactions, and typed errors. - [Unity](https://docs.onside.io/sdk/integrations/unity.md): Integrate OnsideKit into a Unity game targeting iOS with the OnsideKit Unity package — a C# wrapper over the native SDK. - [Local Testing with a .storekit File](https://docs.onside.io/sdk/advanced-and-tooling/local-testing.md): Develop and QA the purchase and restore flows offline with a bundled StoreKit configuration file, without a backend or a real account. - [Testing Installation & Purchases](https://docs.onside.io/sdk/advanced-and-tooling/testing-installation-and-purchases.md): Test an OnsideKit integration during development before your app is notarized and live: simulate the purchase flow with a local StoreKit file, and simulate the alternative-marketplace install source i - [Debugging & installationId](https://docs.onside.io/sdk/advanced-and-tooling/debugging.md): Diagnostics for OnsideKit: the installationId publisher, SDK console logging, and the SSL-pinning debug switch. - [OnsideKit vs OnsideKitLite](https://docs.onside.io/sdk/advanced-and-tooling/onsidekit-lite.md): OnsideKitLite is the SDK without the PassKit dependency (no Apple Pay), for apps that cannot include PassKit. - [Migrating from StoreKit](https://docs.onside.io/sdk/reference/migrating-from-storekit.md): Map StoreKit types and patterns to their OnsideKit equivalents. - [Models](https://docs.onside.io/sdk/reference/models.md): Reference for OnsideKit's public value types: transactions, payments, products, prices and periods. - [Error Reference](https://docs.onside.io/sdk/reference/errors.md): Every OnsideKit error type, its cases, what causes them, and how to handle them. - [Example App](https://docs.onside.io/sdk/reference/example-app.md): A sample app showcasing OnsideKit features: login, fetching products, making purchases, and restoring purchases — as a reference implementation. ## Onside API - [Welcome to the Onside API](https://docs.onside.io/api/welcome-to-the-onside-api.md): An introduction to the Onside API, covering authentication, key concepts, and where to find detailed endpoint references. - [Transactions Reporting API](https://docs.onside.io/api/transactions-reporting-api.md): Transactions Reporting API offers our merchant clients increased flexibility in managing their in-app payments. - [Merchant::reports::transaction](https://docs.onside.io/api/transactions-reporting-api/merchant-reports-transaction.md) - [Models](https://docs.onside.io/api/transactions-reporting-api/models.md) - [Store Attribution Webhooks](https://docs.onside.io/api/store-attribution-webhooks.md): This page describes how attribution events are tracked and sent from the Onside store. These events are primarily used to measure conversions for ad campaigns and connect them with user actions inside - [Onside Install Attribution Flow](https://docs.onside.io/api/onside-install-attribution-flow.md): Onside uses a privacy-friendly token system to track user journeys from landing page to app install. It details events available for marketing analytics and performance. - [Onside Attribution](https://docs.onside.io/api/onside-attribution.md): This document outlines the two key parts of the Onside attribution system: client-side tracking and server-side webhooks. - [Installation and Attribution](https://docs.onside.io/api/onside-attribution/installation-and-attribution.md): This document describes the Onside API endpoint for retrieving app installation and attribution data. It is intended for use by apps and SDKs upon their first launch. - [Server-to-server attribution events](https://docs.onside.io/api/onside-attribution/server-to-server-attribution-events.md): This page describes the server-to-server API for submitting attribution events. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on a page URL with the `ask` query parameter: ``` GET https://docs.onside.io/onside-documentation.md?ask= ``` 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.