# Xsolla SDK

> Xsolla Drop-In SDK documentation — mobile, Unity, and Windows Stores payment integration.

## Welcome

- [Welcome to the Xsolla SDK 3](https://developers.xsolla.com/sdk/): Xsolla SDK 3 is built for developers who want to monetize their game and go live across distribution channels — App Store, Google Play, Android APK, iOS, Xsolla Launcher and standa
- [Core Concepts (Android)](https://developers.xsolla.com/sdk/welcome/core-concepts-android): Going beyond the Google Play Billing Library, to Xsolla SDK involves a few essential steps to ensure seamless integration and functionality. Below is a structured breakdown of the 
- [Core Concepts (iOS)](https://developers.xsolla.com/sdk/welcome/core-concepts-ios): Expanding from Apple's StoreKit Framework to Xsolla SDK involves several key steps to ensure seamless integration and functionality. Here's a structured breakdown of the core conce
- [Mobile Game Distribution Glossary: The DMA Era and U.S. Court Rulings](https://developers.xsolla.com/sdk/welcome/glossary): The Digital Markets Act (DMA) and U.S. court rulings have introduced new concepts in mobile game distribution and monetization. This glossary explains these terms and how Xsolla SD

## compliance

- [Reporting External Transactions to Google Play](https://developers.xsolla.com/sdk/compliance/android): When you sell through Xsolla on storefronts where Google permits external transactions, Google still requires you to report those transactions. This page explains what Google expec
- [Reporting External Purchases to Apple](https://developers.xsolla.com/sdk/compliance/ios): When you sell through Xsolla on storefronts where Apple permits external purchases, Apple still requires you to report those transactions. This page explains what Apple expects, an

## Changelog

- [News](https://developers.xsolla.com/sdk/documentation-changelog): Documentation updates and release notes for the Xsolla SDK.

## Integration Widget

- [Integration](https://developers.xsolla.com/sdk/integration-widget)

## Mobile SDK

- [Xsolla SDK for Mobile](https://developers.xsolla.com/sdk/mobilesdk): The Xsolla SDK for Mobile empowers developers to seamlessly integrate in-game payments via Xsolla Pay Station across iOS and Android games, supporting monetization for both in-stor
- [Google Play User Choice Billing](https://developers.xsolla.com/sdk/mobilesdk/addendum/android/google-play-user-choice-billing): Please route any questions about Google Play User Choice Billing through your Xsolla account manager.
- [Inventory API vs. Events API](https://developers.xsolla.com/sdk/mobilesdk/addendum/android/inventory-vs-events-api): Under the hood, the Android SDK sources purchase data from one of two Xsolla backends: Inventory API or Events API.
- [Buy Button ⚡](https://developers.xsolla.com/sdk/mobilesdk/buy-button): iOS: In the U.S., Japan, and Brazil, Apple now lets developers direct players to external web payments. The Xsolla SDK aligns with Apple’s updated guidelines.
- [Buy Button - Android](https://developers.xsolla.com/sdk/mobilesdk/buy-button/android): Two simple ways to add external payments to your Android app: redirect users to your Web Shop, or launch Pay Station's native in-app UI. Both are production-ready — pick the one th
- [Buy Button - iOS](https://developers.xsolla.com/sdk/mobilesdk/buy-button/ios): iOS: In the U.S., Japan, Brazil, and the EU, Apple now lets developers direct players to external web payments. The Xsolla SDK aligns with Apple’s updated guidelines. In Japan, Bra
- [Quick Start — Mobile SDK](https://developers.xsolla.com/sdk/mobilesdk/quick-start): This quick start guide will walk you through integrating Xsolla Mobile SDK to accept payments in your game. Using a pre-configured test project ID, we'll cover the essentials: sett
- [Quick Start - Android](https://developers.xsolla.com/sdk/mobilesdk/quick-start/android): Get the Xsolla Mobile SDK integrated and process your first test payment. We'll use pre-configured test credentials so you can start in minutes.
- [Android Extended Example](https://developers.xsolla.com/sdk/mobilesdk/quick-start/extended-examples/android-example): Xsolla Mobile SDK requires very few steps to get a working integration, which normally consists of these steps:
- [Quick Start - iOS](https://developers.xsolla.com/sdk/mobilesdk/quick-start/ios): Get the Xsolla Mobile SDK integrated and process your first test payment. We'll use pre-configured test credentials so you can start in minutes.
- [Web Shop and Xsolla SDK: A Symbiotic Relationship](https://developers.xsolla.com/sdk/mobilesdk/quick-start/webshop): Xsolla Web Shop and Xsolla SDK are designed to work well together, creating a powerful ecosystem for game monetization both inside and outside your game. This synergy not only enha
- [How to detect Google Play storefront (Android)?](https://developers.xsolla.com/sdk/mobilesdk/sdk/advanced/detect-gpb-storefront-android): When distributing your app through Google Play, you may need to detect the current storefront to implement region-specific functionality. The storefront represents the Google Play 
- [How to detect store installation?](https://developers.xsolla.com/sdk/mobilesdk/sdk/advanced/detectstore): When distributing your app through alternative channels outside of official app stores (like Google Play Store or Apple's App Store), you may need to detect where your app was inst
- [How to detect iOS Storefront?](https://developers.xsolla.com/sdk/mobilesdk/sdk/advanced/ios-storefront): When distributing your app through Apple's App Store, you may need to detect the current storefront to implement region-specific functionality. The storefront represents the App St
- [iOS Universal Links](https://developers.xsolla.com/sdk/mobilesdk/sdk/advanced/ios-universal-links): When using External Browser flows, returning from Pay Station to your app via a custom URL scheme can trigger an iOS confirmation dialog (for example, “Open this page in App Name?”
- [Trusted Web Activity (Android)](https://developers.xsolla.com/sdk/mobilesdk/sdk/advanced/trusted-web-activity): A Trusted Web Activity (TWA) ↗ (https://developer.chrome.com/docs/android/trusted-web-activity) enables Android apps to display web content in full-screen mode using Chrome, withou
- [Configuration](https://developers.xsolla.com/sdk/mobilesdk/sdk/configuration)
- [Configuration - Android](https://developers.xsolla.com/sdk/mobilesdk/sdk/configuration/android): The Xsolla Mobile SDK for Android splits its configuration into four major settings subcategories, each represented by its own specific class:
- [Configuration - iOS](https://developers.xsolla.com/sdk/mobilesdk/sdk/configuration/ios): This guide covers how to configure the Xsolla Mobile SDK for iOS to enable payment processing in your mobile application. The SDK provides multiple integration approaches, from ful
- [Initialization](https://developers.xsolla.com/sdk/mobilesdk/sdk/initialization)
- [Initialization - Android](https://developers.xsolla.com/sdk/mobilesdk/sdk/initialization/android): After configuring, the Xsolla Mobile SDK needs to be initialized and connected to Xsolla services. Initialization is a 3-step process:
- [Initialization - iOS](https://developers.xsolla.com/sdk/mobilesdk/sdk/initialization/ios): After configuring, the Xsolla Mobile SDK needs to be initialized and connected to Xsolla services.
- [Installation](https://developers.xsolla.com/sdk/mobilesdk/sdk/installation)
- [Installation - Android](https://developers.xsolla.com/sdk/mobilesdk/sdk/installation/android)
- [Installation - iOS](https://developers.xsolla.com/sdk/mobilesdk/sdk/installation/ios): The Xsolla Mobile SDK supports iOS 12.0 and later as the minimum deployment target. However, please note that some features that rely on Apple's APIs for External Purchases or Alte
- [Purchasing flow](https://developers.xsolla.com/sdk/mobilesdk/sdk/purchase)
- [Purchase flow - Android](https://developers.xsolla.com/sdk/mobilesdk/sdk/purchase/android): Purchasing flow is a multistage process, which involves payment collection, purchase validation and consumption. Purchases a player already made are recovered separately, through r
- [Purchase flow - iOS](https://developers.xsolla.com/sdk/mobilesdk/sdk/purchase/ios): Purchasing flow is a multistage process, which involves payment collection, purchase validation and consumption. Purchases the player already made are recovered separately, through
- [Testing & Sandbox](https://developers.xsolla.com/sdk/mobilesdk/sdk/testing)
- [Testing & Sandbox - Android](https://developers.xsolla.com/sdk/mobilesdk/sdk/testing/android): This section provides various snippets and examples of how to configure the sandbox environment to be able to make test payments, make logging more verbose, and so on.
- [Testing & Sandbox - iOS](https://developers.xsolla.com/sdk/mobilesdk/sdk/testing/ios): This section provides various snippets and examples of how to configure the sandbox environment to be able to make test payments, make logging more verbose, and so on.
- [Troubleshooting](https://developers.xsolla.com/sdk/mobilesdk/sdk/troubleshooting)
- [Troubleshooting - iOS](https://developers.xsolla.com/sdk/mobilesdk/sdk/troubleshooting/ios): Common integration issues, their causes, and how to resolve them. If you're coming from Apple StoreKit, a few behaviors differ — those are called out below.
- [Purchase validation](https://developers.xsolla.com/sdk/mobilesdk/sdk/validation)
- [Purchase validation - Android](https://developers.xsolla.com/sdk/mobilesdk/sdk/validation/android): Each purchase should be validated before awarding it to the end-user. This assists in preventing unauthorized purchases and ensures the integrity of your in-app economy. Validating
- [Purchase validation - iOS](https://developers.xsolla.com/sdk/mobilesdk/sdk/validation/ios): Each purchase should be validated before awarding it to the end-user. This assists in preventing unauthorized purchases and ensures the integrity of your in-app economy. Validating

## Offerwall

- [Offerwall SDK](https://developers.xsolla.com/sdk/offerwall): The Xsolla Offerwall SDK will let you surface an offerwall directly inside your game — presenting advertiser tasks, granting virtual rewards, and tracking completions natively, wit

## Publisher Account

- [Publisher Account](https://developers.xsolla.com/sdk/publisher-account): Publisher Account is the central control panel for your Xsolla integration — where you create your project, set up authentication, manage your product catalog, and configure webhoo
- [Finding Your Project IDs](https://developers.xsolla.com/sdk/publisher-account/getids): Locate your Project ID and Login ID in the Publisher Account — you'll need both to initialize the SDK.
- [Going Live](https://developers.xsolla.com/sdk/publisher-account/gotolive): Sign the licensing agreement and switch from sandbox to production — the final steps before accepting real payments.
- [Setting Up Authentication](https://developers.xsolla.com/sdk/publisher-account/login): Configure an authentication method for your Xsolla Login project — choose the approach that fits your app's complexity.
- [Create Project from Store Page](https://developers.xsolla.com/sdk/publisher-account/new-project/setup-fasttrack): Link your Google Play or App Store listing — Xsolla automatically pulls your game's imagery, title, developer information, and color scheme to pre-populate your Publisher Account p
- [Create Project Manually](https://developers.xsolla.com/sdk/publisher-account/new-project/setup-manual): Create a Publisher Account project from scratch and configure Xsolla Login — get your Project ID and Login ID for SDK integration.
- [Configuring Xsolla Catalog](https://developers.xsolla.com/sdk/publisher-account/virtual-items): Set up your Virtual Items (IAPs) — the purchasable products in your Xsolla Catalog, equivalent to in-app purchases from Google Play Billing or StoreKit.
- [Webhooks](https://developers.xsolla.com/sdk/publisher-account/webhooks): When a payment or user validation occurs, Xsolla sends an HTTP request with the event data to your backend.

## technical-articles

- [Hey Developers, this is Xsolla's SDK 3.](https://developers.xsolla.com/sdk/technical-articles/intro-to-sdk3-integrations): Hello Developers! We are Xsolla's Developer Relations Team and in this blog we want to tell you about Xsolla's SDK 3, the latest rev of our software toolkit that enables you to add
- [Native Android — Xsolla SDK 3 Integration Guide](https://developers.xsolla.com/sdk/technical-articles/xsolla-sdk-3-native-android): Integrating a seamless, secure checkout experience shouldn't mean derailing your game's development schedule. In this guide, we're breaking down exactly how to integrate the Xsolla
- [Native iOS — Xsolla SDK 3 Integration Guide](https://developers.xsolla.com/sdk/technical-articles/xsolla-sdk-3-native-ios): Integrating Xsolla SDK 3 into Your Native iOS Game
- [Unity Mobile — Xsolla SDK 3 Integration Guide](https://developers.xsolla.com/sdk/technical-articles/xsolla-sdk-3-unity-mobile): By the end of this walkthrough, you'll have a fully working Xsolla payment flow integrated into a Unity iOS project - from package installation through to a completed test transact
- [Unity PC — Xsolla SDK 3 Integration Guide](https://developers.xsolla.com/sdk/technical-articles/xsolla-sdk-unity-pc): This guide primarily benefits developers targeting off-platform PC distribution and Epic Games Store with dual billing. For testing and release, you'll want to set up a web shop an

## Unity SDK

- [Xsolla SDK for Unity](https://developers.xsolla.com/sdk/unity): The Xsolla SDK for Unity empowers developers to seamlessly integrate in-game payments via Xsolla Pay Station across mobile, PC, and web Unity projects, supporting monetization for 
- [Xsolla SDK for Unity - Mobile](https://developers.xsolla.com/sdk/unity/mobile): iOS: In the U.S., Japan, and Brazil, Apple now lets developers direct players to external web payments. The Xsolla SDK aligns with Apple's updated guidelines.
- [Buy Button - Unity](https://developers.xsolla.com/sdk/unity/mobile/buy-button): Two simple ways to add external payments to your Unity app: redirect users to your Web Shop, or launch Pay Station's native in-app UI. Both are production-ready — pick the one that
- [Xsolla SDK for Unity - PC](https://developers.xsolla.com/sdk/unity/pc): Xsolla SDK for Unity is an evolution of the enterprise-level Xsolla SDK solution, which was designed for integration into large-scale projects.
- [Quick Start — Unity SDK](https://developers.xsolla.com/sdk/unity/quick-start): Get the Xsolla SDK for Unity integrated and process your first test payment. We'll use pre-configured test credentials so you can start in minutes.
- [Extended Example (IAP)](https://developers.xsolla.com/sdk/unity/quick-start/extended-example): Xsolla SDK for Unity plugs into Unity InAppPurchasing through an extension module.
- [How to detect Google Play storefront (Unity/Android)?](https://developers.xsolla.com/sdk/unity/sdk/advanced/detect-gpb-storefront-android): When distributing your app through Google Play, you may need to detect the current storefront to implement region-specific functionality. The storefront represents the Google Play 
- [How to detect store installation?](https://developers.xsolla.com/sdk/unity/sdk/advanced/detectstore): When distributing your app through alternative channels outside of official app stores (like Google Play Store or Apple's App Store), you may need to detect where your app was inst
- [How to detect iOS Storefront?](https://developers.xsolla.com/sdk/unity/sdk/advanced/ios-storefront): When distributing your app through Apple's App Store, you may need to detect the current storefront to implement region-specific functionality. The storefront represents the App St
- [Trusted Web Activity (Unity/Android)](https://developers.xsolla.com/sdk/unity/sdk/advanced/trusted-web-activity): A Trusted Web Activity (TWA) ↗ (https://developer.chrome.com/docs/android/trusted-web-activity) enables Android apps to display web content in full-screen mode using Chrome, withou
- [Configuration](https://developers.xsolla.com/sdk/unity/sdk/configuration): In Unity, settings can be set up either using a settings asset or via code:
- [Configuration - Android](https://developers.xsolla.com/sdk/unity/sdk/configuration/android): Use WebViewType.System or WebViewType.Trusted to enable browser provider controls for Custom Tabs / TWA. Configure provider blacklists, priority weights, and TWA fallback via advan
- [Configuration - iOS](https://developers.xsolla.com/sdk/unity/sdk/configuration/ios): In the United States, Japan, and Brazil, Apple lets developers direct players to external web payments. Use WebViewType.External:
- [Initialization](https://developers.xsolla.com/sdk/unity/sdk/initialization): After configuring, the Xsolla SDK for Unity needs to be initialized and connected to Xsolla services.
- [Installation](https://developers.xsolla.com/sdk/unity/sdk/installation): There are multiple ways to install the Xsolla SDK for Unity plugin in Unity. All of them use the Unity's Package Manager.
- [Resolving Android dependencies](https://developers.xsolla.com/sdk/unity/sdk/installation/resolving-android-dependencies): To resolve the Android dependencies, follow these steps:
- [Xsolla SDK for Unity - Migrating from 2.x to 3.x](https://developers.xsolla.com/sdk/unity/sdk/migration2xto3x): Xsolla SDK for Unity is an evolution of the enterprise-level Xsolla SDK solution, designed for integration into large-scale projects.
- [Purchase flow](https://developers.xsolla.com/sdk/unity/sdk/purchase): Purchasing flow is a multistage process, which involves payment collection, purchase validation and consumption.
- [Testing & Sandbox](https://developers.xsolla.com/sdk/unity/sdk/testing): This section provides various snippets and examples of how to configure the sandbox environment to be able to make test payments, make logging more verbose, and so on.
- [Purchase Validation](https://developers.xsolla.com/sdk/unity/sdk/validation): Each purchase should be validated before awarding it to the end-user. This assists in preventing unauthorized purchases and ensures the integrity of your in-app economy. Validating
- [Xsolla SDK for Unity - Web](https://developers.xsolla.com/sdk/unity/web): Xsolla SDK for Unity is an evolution of the enterprise-level Xsolla SDK solution, which was designed for integration into large-scale projects.

## unreal-pilot

- [Xsolla SDK 3 for Unreal Engine: Early Access Pilot](https://developers.xsolla.com/sdk/unreal-pilot): Xsolla SDK 3 for Unreal Engine is in early access. It handles the commercial layer of your game: signing players in, showing them your catalog, taking their money, and delivering w

## video-guides

- [Native Android — Xsolla SDK 3 Integration Video](https://developers.xsolla.com/sdk/video-guides/video-sdk3-native-android): A step-by-step video walkthrough for integrating the Xsolla SDK into a native Android game (Java). Using a simple clicker-game demo, it shows how to launch a secure Pay Station che
- [Native iOS — Xsolla SDK 3 Integration Video](https://developers.xsolla.com/sdk/video-guides/video-sdk3-native-ios): A step-by-step video walkthrough for Swift developers integrating the Xsolla SDK into a native iOS game — without abandoning StoreKit. The SDK slots in as a thin wrapper around the
- [Unity Mobile — Xsolla SDK 3 Integration Video](https://developers.xsolla.com/sdk/video-guides/video-sdk3-unity-mobile): A step-by-step video walkthrough for Unity developers integrating the Xsolla SDK into a mobile (iOS/Android) game. Built on the Unity 2D Game Kit demo, it implements a buy-full-hea
- [Unity PC — Xsolla SDK 3 Integration Video](https://developers.xsolla.com/sdk/video-guides/video-sdk3-unity-pc): A step-by-step video walkthrough for Unity developers integrating the Xsolla SDK into a PC game for off-platform distribution. Using the Unity 2D Game Kit as a demo, it builds a cl

## windows

- [Xsolla SDK for Windows](https://developers.xsolla.com/sdk/windows): The Xsolla SDK for Windows brings out-of-store commerce, in-app purchases, and global payments to games on the Microsoft platform. With a single integration, the SDK empowers devel

## Windows Stores SDK

- [Xsolla SDK: Powering Commerce for Games on Epic Games Store](https://developers.xsolla.com/sdk/windowstores/epic): Epic Games Store policy allows developers to use alternative payment options, giving studios the freedom to choose the tools that best fit their business. Xsolla’s SDKs and service
- [Simplifying SKU & IAP Catalog Management with Xsolla](https://developers.xsolla.com/sdk/windowstores/epic/catalog-sync): Managing in-game product catalogs across multiple systems is one of the more tedious—but critical—tasks in game commerce. Every platform has its own requirements for defining virtu
- [Best Practices for Dual Billing](https://developers.xsolla.com/sdk/windowstores/epic/dual-billing): Implementing a dual billing experience in your Windows game gives players more choice at checkout—and that choice should feel meaningful. As Epic Games has outlined in their own gu
- [Configuration](https://developers.xsolla.com/sdk/windowstores/sdk/configuration): To Configure SDk please use following code:
- [Initialization](https://developers.xsolla.com/sdk/windowstores/sdk/initialization): After configuring, the Xsolla SDK for Windows needs to be initialized and connected to Xsolla services.
- [Installation](https://developers.xsolla.com/sdk/windowstores/sdk/installation)
- [Purchase flow](https://developers.xsolla.com/sdk/windowstores/sdk/purchase): Purchasing flow is a multistage process, which involves payment collection, purchase validation and consumption.
- [Testing & Sandbox](https://developers.xsolla.com/sdk/windowstores/sdk/testing): This section provides various snippets and examples of how to configure the sandbox environment to be able to make test payments, make logging more verbose, and so on.
- [Purchase Validation](https://developers.xsolla.com/sdk/windowstores/sdk/validation): Each purchase should be validated before awarding it to the end-user. This assists in preventing unauthorized purchases and ensures the integrity of your in-app economy. Validating