Solutions

Web Shop

Overview Integration flow Demo walkthrough

Catalog and items

Create project Import item catalog from JSON file Import item catalog from external platforms Set up catalog manually Automatic catalog update via API Grant purchases to user Set up subscription sales

Create Web Shop

Legal aspects Create site and customize main blocks Localization Set up user authentication Publish news articles on your site Set up Progressive Web Application

Promotions

Personalization Free items Featured offers Discount promotions Bonus promotions Promo codes and coupons Time limited and number limited offers Daily rewards Reward system Offer chain Referral program First Login Reward via PWA Using query parameters

Test and publish Web Shop

Test Web Shop in sandbox mode Publish Web Shop Access restrictions Test Web Shop in live mode

Analytics

Integration with AppsFlyer Integration with Adjust Integration with Singular Connecting analytics services

Buy Button for mobile games

Overview Enable Buy Button via link-outs to Web Shop Enable Buy Button via Mobile SDK Enable Buy Button with custom checkout

Payments

Overview Integration scenarios

Generation of payment token on client side

Get started Create and set up project in Publisher Account Authenticate users in your application Get catalog on client side of application Set up item purchase Set up order status tracking Launch

Generation of payment token on server side

Get started Create and set up project in Publisher Account Get catalog in your application Set up item purchase Set up order status tracking Launch

Testing

Sandbox and production environments Test cards in sandbox mode Test Apple Pay in sandbox mode Test PayPal in sandbox mode Test real payments Test cards list API reference for sandbox

Catalog configuration

Catalog creation Catalog import Personalization

Customization

Payment UI theme customization Design guidelines Receipt email customization

Promotions

Coupons Bonus promotions Discount promotions

Payment UI management

Payment UI localization Payment methods setup Top payment methods management Redirects configuration Tokenization Event analytics

Anti-fraud

Overview Anti-fraud setup Anti-fraud analytics in Publisher Account Chargeback Chargeback and dispute fee

Cloud Gaming

Overview Integration flow

Integration guide

Prerequisites Uploading game build in Publisher Account

How-tos

How to manage game streams and pricing How to work with promotions How to delete game How to set up virtual gamepad How to enable voice input

Promotions

Play before you buy

Features

Allowlist Game keys for external platforms Play Now button

Digital Distribution Hub Loyalty as service

XPS

Build your publishing platform

Overview Set up publishing platform using headless CMS Create multi-page site to sell your games

Sell virtual goods in-game or online

Overview Use F2P template Use your own UI

Prerequisites

Create project Sign licensing agreement Pass tax interview

Sell game keys

Launch pre-orders Deliver a game with Launcher Set up a cross-platform monetization

Products

Pay Station

Shop Builder

Overview

Integration guide

Get started Use ready-to-use solutions Create project Create catalog in Publisher Account Set up webhooks Legal aspects Set up selling items Integrate store into game Set up promotional campaigns

Features

How-tos

How to create and update an item catalog using JSON import How to group bundles in catalog How to import catalog How to group and sort items in catalog How to encourage users to make first purchase How to provide users with daily rewards How to create items not for sale How to automate catalog updates

Extensions

Integration with PlayFab

References

API reference SDKs Errors list Supported countries Supported languages

Tutorials

Item catalog personalization

Subscriptions

Site Builder

Partner Network

Overview API reference FAQs

Integration guide

Get started Create project Set up Login project in Publisher Account Connect user data storage Integrate solution on application side

Authentication options

Passwordless login Cross-platform account Silent authentication Login with device ID Social login Authentication via your own OAuth 2.0 provider

User data storage

What is it for Comparison of user data storage options Xsolla storage PlayFab storage Firebase storage Custom user data storage Managing the collection of user data

Security

What is it for OAuth 2.0 protocol Single Sign-on JWT signature Email address validation

Customization

What is it for Widget customization JSON files with widget settings Email customization SMS customization

Communication service providers

What is it for Email providers SMS providers

Features

Collecting email addresses and phone numbers JSON to user profile key name map Tracking new users Delayed registration in browser games Displaying authentication statistics User attributes User data import and export Additional features Working with users

How-tos

How to set up a shadow Login project How to export users to Mailchimp How to create Mailchimp merge tags How to integrate User Account How to integrate user authentication via Xsolla account How to use Login Widget SDK API calls

Extensions

Integration with Zendesk Chat Authorization in Xsolla Publisher Account via Okta

Legal settings

Terms and policies Processing of personal data Age restrictions

References

Metaframe

Launcher

Overview

Integration guide

Get started Create project Create launcher Configure launcher settings Configure game settings Configure content Upload game build Generate installer

Features

Web games distribution Binary patching In-game user authentication Deep links List of ignored files in Build Loader Tabs Game content delivery Offline mode Seamless web-to-game integration

How-tos

How to enable seamless authorization How to transfer user data via launcher installer How to send data to Google Analytics 4 How to connect additional games to the launcher How to integrate Launcher with Epic Games Store How to integrate launcher with Steam How to carry out maintenance of a game How to enable buying games in the launcher How to set up launcher installer name

Extensions

How to use Epic Online Services with Xsolla Login

References

FAQs Launcher system requirements

Chat

Overview

Integration guide

Integration with Slack Integration with Discord Integration with Zendesk

Managing catalog and LiveOps via canvas

Overview

Catalog management

General information Create group Create item Import and export the item catalog in JSON format Import item catalog from external platforms Import country-specific prices from CSV file

LiveOps campaign management

Create bonus promotion Create discount promotion Create promo code promotion

Xsolla Partner Ecosystem FAQs

Roadmap

Overview

API references

Pay Station API Subscriptions API Shop Builder API Webhooks Login API DDH API Getting started

SDKs & libraries

Xsolla Mobile SDK

Headless checkout

SDK for Unity (PC, web)

Overview SDK reference documentation

Integration guide

Get started Create project in Publisher Account Set up basic Login project Install SDK Set up SDK Set up catalog and subscription plans Integrate SDK on application side Test payment process in sandbox mode Go live

BaaS integrations

How to use Pay Station in combination with PlayFab authentication How to use Pay Station in combination with Firebase authentication

Demo project

General information How to use snippets from demo project in your project How to use SDK to configure application UI

Authentication

General information Classic login via username/email and password Passwordless login Social login Authentication via application launcher Authentication via custom ID Silent authentication via publishing platform Xsolla Login widget

Catalog

General information Display item catalog in your application

Subscriptions

General information Subscription purchase scenario Subscription management scenario

Promotions

General information Coupons Promo codes Personalized offers Free items

Item purchase

General information Purchase in one click Purchase for virtual currency Purchase via shopping cart Track order status Payments via Steam

Player inventory

General information Display player inventory in your application Consume virtual items and currencies from player inventory

User account and attributes

General information User attributes User account Account linking

Application build guides

How to create an application build to run in a browser How to change built-in browser

Troubleshooting

Error occurred running Unity content on page of WebGL build The type or namespace name Input.System does not exist Error when calling authentication method Access has been blocked by CORS policy

How to migrate to SDK version 1.0.0 and higher How to migrate to SDK version 2.0.0 and higher

Ready-to-use store (Unity)

Overview

Module usage

Prerequisites Initialization

Customization and advanced settings

Additional parameters for OpenStore() Common customization scenarios

SDK for Unreal Engine

Overview SDK reference documentation

Integration guide

BaaS integrations

How to use Pay Station in combination with PlayFab authentication

Demo project

General information How to use SDK to configure application UI

Authentication

General information Classic login via username/email and password Authentication via device ID Passwordless login Social login Authentication via application launcher Authentication via custom ID Silent authentication via publishing platform Xsolla Login widget

Catalog

General information Display item catalog in your application

Subscriptions

General information Subscription purchase scenario Subscription management scenario

Promotions

General information Coupons Promo codes Personalized offers Free items

Item purchase

General information Purchase in one click Purchase for virtual currency Purchase via shopping cart Purchase of single item Track order status

Player inventory

General information Display player inventory in your application Consume virtual items and currencies from player inventory

User account and attributes

General information User attributes User account Account linking

Application build guides

How to integrate SDKs in projects for Android applications

How to modify SDK

SDK for Cocos Creator

Overview

Integration guide

Get started Create project in Publisher Account Set up basic Login project Install SDK Initialize SDK Set up catalog and subscription plans Integrate SDK on application side Test payment process in sandbox mode Go live

Demo project

General information How to use snippets from demo project in your project

Authentication

General information Classic login via username/email and password Authentication via device ID Passwordless login Social login Authentication via custom ID Xsolla Login widget

Catalog

General information Display item catalog in your application

Promotions

General information Coupons Promo codes Personalized offers Free items

Subscriptions

General information Subscription purchase scenario Subscription management scenario

Item purchase

General information Purchase in one click Purchase for virtual currency Purchase via shopping cart Track order status

Player inventory

General information Display player inventory in your application Consume virtual items and currencies from player inventory

User account and attributes

General information User attributes User account Account linking

Troubleshooting

Access has been blocked by CORS policy

How to connect native Xsolla SDK for Android to your project How to connect native Xsolla SDK for iOS to your project

Extensions for BaaS

Overview Use Shop Builder with BaaS authorization Receive Xsolla webhooks

PHP

Overview Get started Install library Set up webhooks Recommended webhooks Troubleshooting

Management via Publisher Account

You can use Publisher Account to easily manage payments:

View transaction history and stats and upload transaction data in Accounting > Transaction registry.

Reconcile calculations in Accounting > Payouts.

Export reports for legal compliance in Accounting > Reports.

Guide for your support department (PDF)

Learn about features of the Player support section in Publisher Account.

Search transactions, see transaction details, and refund payments in Player support > Transaction search.

Find support tickets in Player support > Support tickets.

Thank you for your feedback!

We’ll review your message and use it to help us improve your experience.

Last updated: September 17, 2025

Found a typo or other text error? Select the text and press Ctrl+Enter.

Your browser is not supported. Please try a different browser

Management via Publisher Account