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:
- Open your Publisher Account.
- Go to Accounting > Transaction registry.
- Check the Show test transactions box.
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:
- Sign the licensing agreement with Xsolla in Publisher Account in the Agreements & taxes > Agreements section.
- Remove the
“settings.mode”: “sandbox”
parameter from the request body when obtaining a token. - Open the payment UI using the following link:
https://secure.xsolla.com/paystation4/?token=TOKEN
, whereTOKEN
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
Found a typo or other text error? Select the text and press Ctrl+Enter.