Sandbox and production environments

Overview

Sandbox mode is a stand-alone environment that includes all features of the production environment (live mode) except for user authorization and the ability to make real payments.

In sandbox mode, you can make payments using any payment method available in the payment UI, except real bank cards. For testing, use the test bank cards from the list. When making payment in sandbox mode, no funds are deducted from real accounts. For testing with test bank cards and PayPal, you can follow available scenarios.

After making the payment, you receive a receipt identical to the one sent after completing real payments. The receipt is sent to the email passed in the token request. If you enabled webhooks in your project, you will also receive a webhook about a successful payment.

To see detailed information, including fees, about transactions made in sandbox mode:

1. Open your Publisher Account.
2. Go to Accounting > Transaction registry.
3. Check the Show test transactions box.

If you receive the 0004-0008 error when opening the payment UI, check in the transaction registry in Publisher Account if there were any real payments made in your project. In such projects, only users specified in the Company settings > Users section can open the payment UI in sandbox mode.

Switching between environments

To access sandbox mode, pass the “settings.mode”: “sandbox” parameter in the request body for obtaining the token. To open the payment UI, use the following URL: https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN, where TOKEN is the received token.

To switch to production environment:

1. Sign the licensing agreement with Xsolla in Publisher Account in the Agreements & taxes > Agreements section.
2. Remove the “settings.mode”: “sandbox” parameter from the request body when obtaining a token.
3. Open the payment UI using the following link: https://secure.xsolla.com/paystation4/?token=TOKEN, where TOKEN is the received token.

Options for payment process testing

You can explore the main Pay Station features while testing the payment process via API or interaction with the payment UI. The following testing options are available:

• testing bank cards in sandbox mode
• testing PayPal in sandbox mode
• making a real payment and requesting refund