Initialization

Call the XsollaReadyToUseStore.OpenStore() method to display the store and initialize all related logic. Add this call at an appropriate place in a user scenario in your application, e.g., when clicking the Open store button.

This method automatically adds the StoreDirector prefab to the scene, which handles:

  • user authentication
  • item catalog loading
  • store UI rendering

Note
The Xsolla Login widget appears when user navigates to the store in the following cases:
  • The user is not authenticated.
  • The user’s token has expired.

To handle successful purchases, subscribe to the XsollaReadyToUseStore.OnPurchaseSuccess event. This event is fired when an order moves to the done status. For more information on the order status tracking mechanism, refer to the instruction.

Notice
The Ready-to-use store module handles catalog display and the purchase flow but doesn’t automatically grant purchases to users. You must implement your own logic to grant purchases in the game after successful payment.

After integrating the Ready-to-use store module, you can accept payments in the sandbox environment. To start accepting real payments, follow the instructions in the Go live section.

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: October 10, 2025

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

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.