Integration errors

CodeDescriptionTroubleshooting
0002-0004The 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. If there are any questions during the verification process, we will notify the contact person indicated in the application. After the checking procedure is completed on Xsolla’s side, the status of your agreement will change to Signed.
0004-0008Invalid URL for opening the payment UI.Check if you use the correct URL address:
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, 2207Invalid user ID.
  • Pass a valid user ID which is user_id from your database.
  • Recommendations regarding webhook usage:
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: November 25, 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.