Self-integration

This guide describes self-integration with Xsolla to allow users to pay for purchases with your payment methods. On your side, implementation can be done in one of the following ways:

• as a proxy server that interacts with your API
• as a dedicated service built specifically for integration with Xsolla

The Xsolla API specification is based on REST architecture principles. It uses HTTP status codes to indicate errors and URLs that resemble directory structures. API responses, including errors, are returned in JSON format.

On your side, you need to:

• implement methods to receive requests from Xsolla, verify HTTP message signatures, and send responses according to the API contract
• configure sending webhooks to Xsolla signed with HTTP Message Signatures, e.g., to notify about payment status

Available scenarios of user interaction with the payment UI:

• payment within the Xsolla payment UI
• payment with redirection to your page
• payment via QR code
• saving a payment method (with redirection to your page)
• payment with saving a payment method (with redirection to your page)