All Mobile games Free-to-play PC games Premium PC games Web games Payment providers
Home Page
Get started
About Xsolla
Work in Publisher Account
Create first project
Legal aspects
Quickstart with Xsolla SDK
SDK explorer
Documentation
Solutions
Web Shop
Overview Integration flow Demo walkthrough
Catalog and items
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
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
Offerwall
Promo codes and coupons
Item purchase limits
Promotion usage limits
Daily rewards
Reward system
Offer chain
Referral program
First Login Reward via PWA
Social quests
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
Integration with Airbridge
Integration with Tenjin
Connecting analytics services
Buy Button for mobile games
Overview
Enable Buy Button via link-outs to Web Shop
Enable Buy Button via Xsolla SDK
Enable Buy Button with custom checkout
Payments
Xsolla Publishing Suite
Build your publishing platform
Sell virtual goods in-game or online
Sell game keys
Launch pre-orders
Deliver a game with Launcher
Set up a cross-platform monetization
Authenticate and manage users
Login
Overview API reference FAQs
Integration guide
Get started
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
Sell virtual goods in-game or online
Get started
Use F2P template
Use your own UI
Overview
Generate payment token on client side
Get started
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
Generate payment token on server side
Get started
Create items in Publisher Account
Get catalog in your application
Set up item purchase
Set up order status tracking
Launch
Sell subscriptions
Overview
Integration guide
Get started
Set up subscription plan
Set up user authentication
Set up subscription catalog display and purchase
Get subscription information
Features
Grace period
Retry period
Gift subscription
Subscriber account
How-tos
How to cancel last payment if subscription is canceled
How to allow a user to change a subscription plan
How to change the charge amount for an active subscription
How to manually renew subscriptions
How to set up bonuses
How to set up coupons
How to avoid fraud
How to increase first payment for subscription
How to set up selling multiple plans or subscriptions for a single user
How to set up subscription-based products and plan groups
Sell game keys
Get started
Use your own UI
Use ready-made solutions
Overview
Set up publishing platform using headless CMS
Create multi-page site to sell your games
How-tos
How to set up authentication when selling game keys
How to launch pre-orders
How to configure entitlement system
Distribute your games
Launcher
Overview
Integration guide
Get started
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
Launcher system requirements
Cloud Gaming
Overview Integration flow
Integration guide
Set up Login project in Publisher Account
Uploading game build in Publisher Account
How-tos
How to manage game streams and pricing
How to work with promotions
How to set up virtual gamepad
How to enable voice input
How to delete game
Features
Allowlist
Cloud game keys sale
Play Now button
Digital Distribution Hub
Items catalog
Item types
Virtual items
Virtual currency
Bundles
Game keys packages
Bundle with game keys
Catalog management
Set up catalog manually
Automate catalog creation and updates using API
How to create and update an item catalog using JSON import
Import catalog from external platforms
Catalog features
Managing item availability in catalog
How to group and sort items in catalog
Item attributes
Free items
Item purchase limits
Time limit for displaying items in store
Local prices
Regional sale restrictions
LiveOps and promotion tools
Available LiveOps and promotion tools
Discounts
Bonuses
Coupons
Promo codes
Reward system
Daily rewards
Offer chains
Loyalty as service
Referral program
Upsell
Personalization
Unique catalog offer
Promotion usage limits
LiveOps management
Item catalog personalization
Time limits scheduler for items and promotions
How to encourage users to make first purchase
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
Create personalized catalog
Configure payment UI and flow
Overview
Payment UI
Get token to open payment UI
Open payment UI
Open payment UI in mobile application
Customize payment UI
Customize receipt emails
Configure redirects
Localization
Display Xsolla logo
Payment methods
One-click payment
Top payment methods management
Payment method setup
Features
Gateways
Tokenization
Refund
Event analytics
Payments in compliance with Content Security Policy (CSP)
Opening external browser from game launcher
Management via Publisher Account
Anti-fraud
Overview
Anti-fraud setup
Anti-fraud analytics in Publisher Account
Chargeback
Chargeback and dispute fee
Build web storefront
Overview
Quick start
Get started
Blocks
Create site
Create Web Shop for mobile games
How to create site for selling game keys
Access restrictions
Publish site
Store
How to configure site to sell goods
Possible items
Test site in sandbox mode
Test site in live mode
Content
How to publish news articles on your site
How to manage website pages
Localization
Localization
How to display content depending on site language
Design
How to use custom fonts on your site
How to implement parallax scroll
How to show images in modal windows
Analytics and promotion
Services and applications
How to connect analytics services
Grow your audience with user acquisition tools
Overview
Integration guide
Get started
Integrate payment solution
Set up payment attribution
Create and launch campaign
Features
Promo codes with fixed discount
Promo codes with flexible discount
Game key distribution
Participation guidelines
Creator storefront
Individual statistics on creators
Rosters
Reports on rosters coverage
Game information
How-tos
How to edit active campaigns
How to find and invite creator to campaign
How to customize affiliate & affiliate network campaigns
How to set up and customize dedicated domain
How to set up campaign with Creator tag
References
Attribution types
Recommendations for creator campaigns
Promo materials for affiliate networks
Creator Account
Build custom UX
Emails on account activity
SMS to authenticate users
Login widget
Payment UI themes
Receipts
Custom payment UI
For payment providers
Overview
Integration flow
Implementation
Roadmap
Overview
Developers resources
References
Errors
Integration errors
Payment errors
Login errors
Store errors
Supported currencies
Supported countries
Supported languages
Supported browsers
Payment testing
Sandbox and production environments
Test bank cards list
Payment in sandbox mode
Payment with bank cards in sandbox mode
Payment via Apple Pay in sandbox mode
Payment via PayPal in sandbox mode
Real payment testing
API reference for sandbox
FAQs
Overview
General questions
Payment configuration
User authentication
Xsolla Launcher setup
User acquisition
Communication with Xsolla via chat
Overview
Integration guide
Integration with Slack
Integration with Discord
Integration with Zendesk
Xsolla Partner Ecosystem
API and webhooks
Getting started
Pay Station API
Catalog API
LiveOps API
Login API
Subscriptions API
Webhooks
Event API
DDH API
SDKs & libraries
Available SDKs and libraries
Xsolla SDK 🚀
Xsolla SDK for Unity (legacy/enterprise)
Latest versionV 1V 0
Overview SDK reference documentation
Game Commerce asset
Get started
Xsolla servers integration
Server-side integration
Known issues
Login & Account System asset
Get started
Install asset
Set up basic Login project
Set up Unity project
Known issues
Cross-Buy asset
Get started
Install asset
Set up basic Login project
Set up catalog
Set up Unity project
Known issues
Tutorials
Authentication
Purchase management
How-tos
Authentication
Purchase management
User management
Application build
Additional features
How to switch to Game Commerce asset from other Xsolla assets
Xsolla SDK for Unreal Engine
Latest versionV 0
Overview SDK reference documentation
Integration guide
Get started
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
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
Xsolla SDK for Cocos Creator
Overview
Integration guide
Get started
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
Headless checkout
Overview
Integration guide
Get started
Install SDK
Integrate SDK on application side
Test payment process in sandbox mode
Go live
Configure payment methods
How to get list of available payment methods
How to set up payment with saved methods
Bank cards
Mobile payments
E-wallets with redirect
Google Pay
Apple Pay
QR code payment
References
SDK components
Receiving payment method data
Errors
Styles
Supported languages
Ready-to-use store (Unity)
Overview
Module usage
Prerequisites
Initialization
Customization and advanced settings
Additional parameters for OpenStore()
Common customization scenarios
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

Set up catalog

Follow the step-by-step instructions to set up virtual currencies and virtual items in your Publisher Account:

Was this article helpful?
Thank you!
Is there anything we can improve? Message
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.

Continue reading

Next steps

Set up Virtual Items module Set up Unity project
Last updated: March 29, 2023

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

System status
All services operational
Partial outage
© 2006–2026 Xsolla Inc.
Report a problem
We always review our content. Your feedback helps us improve it.
Provide an email so we can follow up
Thank you for your feedback!
We couldn't send your feedback
Try again later or contact us at doc_feedback@xsolla.com.