Code	Description	Troubleshooting
0002-0004	The licensing agreement with Xsolla was not signed.	Sign the Licensing Agreement with Xsolla. It will allow you to complete the integration and start accepting real payments. In Publisher Account, go to the Agreements & Taxes > Agreements > Licensing Agreement section, complete the form, and wait for approval. Your application will be reviewed within 3 business days. In addition to checking all legal aspects, we check the game for adult content, copyright issues, and other prohibited or restricted content. Additional details: The 3-day period covers our initial response or a request for additional information. It doesn’t guarantee that the application will be fully approved within this timeframe. If any questions arise during the review, we will contact the person specified in the application. Once the review is complete and all requirements are met on Xsolla’s side, the status of your agreement will change to Signed.
0004-0008	Invalid URL for opening the payment UI.	Check if you use the correct URL address: To open the payment UI in sandbox mode, follow the link: `https://sandbox-secure.xsolla.com/paystation4/?token=ACCESS_TOKEN`, where `ACCESS_TOKEN` is the received token. To make real payments, follow the link: `https://secure.xsolla.com/paystation4/?token=ACCESS_TOKEN`, where `ACCESS_TOKEN` is the received token. If there are real payments made in your project, only users specified in the Company settings > Users section can open the payment UI in sandbox mode. You can find the transaction registry in Publisher Account in the Accounting section.
2205, 2207	Invalid user ID.	Pass a valid user ID which is `user_id` from your database. Recommendations regarding webhook usage: If you don’t want to use webhooks, make sure they are disabled in your project. To do that, go to Publisher Account, and in the Project settings > Webhooks section, set the toggle to Off. If you want to use webhooks, implement successful processing of the User validation webhook.

Sign the Licensing Agreement with Xsolla. It will allow you to complete the integration and start accepting real payments. In Publisher Account, go to the Agreements & Taxes > Agreements > Licensing Agreement section, complete the form, and wait for approval.

Your application will be reviewed within 3 business days. In addition to checking all legal aspects, we check the game for adult content, copyright issues, and other prohibited or restricted content.

Additional details:

The 3-day period covers our initial response or a request for additional information. It doesn’t guarantee that the application will be fully approved within this timeframe.
If any questions arise during the review, we will contact the person specified in the application.
Once the review is complete and all requirements are met on Xsolla’s side, the status of your agreement will change to Signed.

0004-0008

Invalid URL for opening the payment UI.

Check if you use the correct URL address:

To open the payment UI in sandbox mode, follow the link: https://sandbox-secure.xsolla.com/paystation4/?token=ACCESS_TOKEN, where ACCESS_TOKEN is the received token.
To make real payments, follow the link: https://secure.xsolla.com/paystation4/?token=ACCESS_TOKEN, where ACCESS_TOKEN is the received token.

If there are real payments made in your project, only users specified in the Company settings > Users section can open the payment UI in sandbox mode. You can find the transaction registry in Publisher Account in the Accounting section.

2205, 2207

Invalid user ID.

Pass a valid user ID which is user_id from your database.
Recommendations regarding webhook usage:
- If you don’t want to use webhooks, make sure they are disabled in your project. To do that, go to Publisher Account, and in the Project settings > Webhooks section, set the toggle to Off.
- If you want to use webhooks, implement successful processing of the User validation webhook.

Thank you for your feedback!

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

Last updated: April 30, 2026

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