Mobile games Free-to-play PC games Premium PC games Web games Payment providers Creators Publisher Account (legacy)
Home Page
Get started
About Xsolla
Using AI with Xsolla Docs
Work in Publisher AccountWork in Business AccountWork in Business AccountWork in Business AccountWork in Business Account
Create first project
Legal aspects
Quickstart with Xsolla SDK
SDK explorer
Documentation
Solutions
Web Shop
Overview Integration flow
Quick start
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
Xsolla Bot in Discord
Blocks
How to add media to blocks
How to manage website pages
How to display content depending on site language
How to use custom fonts on your site
How to implement parallax scroll
How to show images in modal windows
Promotions
Personalization
Free items
Featured offers
Discount promotions
Bonus promotions
Offerwall
Promo codes and couponsPromo codes
Item purchase limits
Promotion usage limits
Daily rewards
Reward system
Offer chain
Referral program
First Login Reward via PWA
Push notifications
Social quests
Using query parameters
Time limits scheduler for items and promotions
LiveOps builder for campaigns
Test and publish Web Shop
Access restrictions
Test Web Shop in sandbox mode
Publish Web Shop
Test Web Shop in live mode
Analytics
Ecosystem score
Analytics on canvas
Integration with AppsFlyer
Integration with Adjust
Integration with Singular
Integration with Airbridge
Integration with Tenjin
Authentication configuration for integration with MMPs
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 PC 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 AccountSet up Login project in your accountSet up Login project in your accountSet up Login project in your accountSet up Login project in your 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 ID
How to use Login Widget SDK API calls
Seamless authentication via social network access token
Extensions
Integration with Zendesk Chat
Authorization in Xsolla Publisher Account via OktaAuthorization in Xsolla Account via OktaAuthorization in Xsolla Account via OktaAuthorization in Xsolla Account via OktaAuthorization in Xsolla 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 AccountSet up project in accountSet up project in accountSet up project in accountSet up project in 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 AccountCreate items in accountCreate items in accountCreate items in accountCreate items in 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
Xsolla Bot in Discord
Overview Sell in Discord Reward users in Discord
Xsolla Bot in Discord setup walkthrough
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 cloud game project and upload game build
Test game in sandbox mode
Set up game distribution
How-tos
How to manage game streams and pricing
How to enable free trial and allowlisting
How to set up virtual gamepad
How to enable voice input
How to delete game
How to work with game analytics
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
How to encourage users to make first purchase
Analytics on canvas
Time limits scheduler for items and promotions
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
Create daily rewards
Create reward chain
Create offer chain
Create campaign with LiveOps builder
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 AccountManagement via accountManagement via accountManagement via accountManagement via account
Anti-fraud
Overview
Anti-fraud setup
Anti-fraud analytics in Publisher AccountAnti-fraud analytics in your accountAnti-fraud analytics in your accountAnti-fraud analytics in your accountAnti-fraud analytics in your account
Chargeback
Chargeback and dispute fee
Evidence submission for chargeback disputes
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 add media to blocks
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
Discount promo codes
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
References
Attribution types
Best practices for creator campaigns
Build custom UX
Emails on account activity
SMS to authenticate users
Login widget
Payment UI themes
Receipts
Custom payment UI
For payment providers
Work in account
Create company profile
Add payment methods
Sign payment services agreement
Integration guide
Overview
Integration flow
Implementation
Additional features
Analytics
Launch marketing campaign
Create branded store
For creators
Overview
Get started
Campaigns
Statistics
Creator Site
Creator storefront
Chatbot
Overlay
Payouts
Settings
FAQ
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
Communication Hub
Integration with platforms
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
Analytics API
SDKs & libraries
Available SDKs and libraries
Xsolla SDK 🚀
Client-side libraries
Xsolla SDK for Unity (legacy/enterprise)
Latest versionV 1
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
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
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
Managing user subscriptions
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 set up application build for Android 13
How to create an application build to run in a browser
How to change built-in browser
Troubleshooting
Unable to resolve reference UnityEditor.iOS.Extensions.Xcode
Error occurred running Unity content on page of WebGL build
Error building Xcode project
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
Xsolla SDK for Unreal Engine
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
UI libraries and functional modules
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
Server-side and cloud tools
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

First Login Reward via PWA

The first login reward feature allows you grant users a one-time reward when they log in via an installed Progressive Web Application (PWA) version of your Web Shop. This feature is configured in Site Builder and works only in published Web Shops with PWA installation enabled.

Note
Users who installed the PWA before the reward feature was enabled can still receive it. It will appear on their first login via the installed application after the feature is enabled for your Web Shop – if the user hasn’t received the reward yet.

User flow

Note
The reward pop-up is displayed only during login via the installed PWA, and if the reward hasn’t been received yet.

Requirements

  • PWA installation must be enabled on your website.
  • To be available for selection as a reward in Site Builder, the item must meet the following conditions:
    • Marked as free.
    • Limited to 1 per user:
      • The Limits for single user toggle is set to active.
      • The Number of times item can be bought field is set to 1.
    • Has Available status in the Items catalog.

  • PWA installation must be enabled on your website.
  • To be available for selection as a reward in Site Builder, the item must meet the following conditions:
    • Marked as free.
    • Limited to 1 per user:
      • The Limits for single user toggle is set to active.
      • The Number of times item can be bought field is set to 1.
    • Has Available status in the Items catalog.

  • PWA installation must be enabled on your website.
  • To be available for selection as a reward in Site Builder, the item must meet the following conditions:
    • Marked as free.
    • Limited to 1 per user:
      • The Limits for single user toggle is set to active.
      • The Number of times item can be bought field is set to 1.
    • Has Available status in the Items catalog.

  • PWA installation must be enabled on your website.
  • To be available for selection as a reward in Site Builder, the item must meet the following conditions:
    • Marked as free.
    • Limited to 1 per user:
      • The Limits for single user toggle is set to active.
      • The Number of times item can be bought field is set to 1.
    • Has Available status in the Items catalog.

  • PWA installation must be enabled on your website.
  • To be available for selection as a reward in site builder, the item must meet the following conditions:
    • Marked as free.
    • Limited to 1 per user:
      • The Limits for single user toggle is set to active.
      • The Number of times item can be bought field is set to 1.
    • Has Available status in the Catalog.

Note
If your project uses partner side catalog personalization, make sure that for this reward, the value 1 is passed in the quantity parameter in the Catalog personalization on partner side webhook response. Per-user quantity tracking must be implemented on the game side.

How to set up

Note

Only free items with a limit of 1 per user are available for selection in Site Builder.

Supported reward types: virtual items, virtual currency packages, and bundles.

  1. Open your project in Publisher Account and go to the Storefronts > Websites section.

  2. In the pane of your Web Shop site, click Open Site Builder.

  1. Open the project in your account and go to the Storefronts > Websites section.

  2. In the pane of your Web Shop site, click Open Site Builder.

  1. Open the project in your account and go to the Storefronts > Websites section.

  2. In the pane of your Web Shop site, click Open Site Builder.

  1. Open the project in your account and go to the Storefronts > Websites section.

  2. In the pane of your Web Shop site, click Open Site Builder.

  1. Open your project in the account for mobile games and go to the Web Shop section.
  2. Click the pane of your site.
  1. Go to Web App settings.
  2. Set the Web App reward toggle to active and select the item from the list.
  1. Configure the reward pop-up. In the Select overlay menu, choose Reward pop-up, and if needed, edit the title, description, and button text.
  1. To apply changes, publish your site.
Note
The reward pop-up is displayed only if the Web App reward toggle is set to active and a reward item is selected.
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.
Last updated: September 30, 2026

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 [email protected].