# Xsolla SDK

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

## Welcome

- [Welcome to the Xsolla SDK](https://developers.xsolla.com/sdk/): Xsolla SDK is a versatile solution built by Xsolla — a global video game commerce leader trusted by the game studios behind Crossout, Modern Warship, and Fantasy Tales: Sword and M
- [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

## 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.
- [Buy Button ⚡](https://developers.xsolla.com/sdk/mobilesdk/buy-button): iOS — Effective Apr 30, 2025: Developers may include external payment links in U.S. apps. 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 — Effective Apr 30, 2025: Developers may include external payment links in U.S. apps. The Xsolla SDK aligns with Apple’s updated guidelines.
- [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 seamlessly together, creating a powerful ecosystem for game monetization both inside and outside your game. This synergy not onl
- [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.
- [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.
- [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.
- [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): Notifications about events in the Xsolla ecosystem — when a payment or user validation occurs, Xsolla sends an HTTP request with event data to your game server.

## 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 — Effective Apr 30, 2025: Developers may include external payment links in U.S. apps. 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 seamlessly integrates with Unity InAppPurchasing by providing an extension module for it.
- [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): For more advanced compliance scenarios, you can programmatically detect the user's region and distribution channel to automatically configure the appropriate settings. Learn how to
- [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.

## 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