Test making one-time purchase in sandbox mode

Sandbox mode is a stand-alone environment that supports all the features of a live environment, except real and declined payments. You can access sandbox mode by sending "mode":"sandbox" when you get the token.

To open the payment UI, use this link and specify the obtained token there: https://sandbox-secure.xsolla.com/paystation3/?access_token={token}.

In sandbox mode, you can test a one-time purchase with:

Test bank card payment

In sandbox mode, you can test the following payment UI interaction scenarios while making a payment with a bank card:

Making a test payment

  1. Open the payment UI in sandbox mode.
  2. Choose the Credit/Debit cards group of payment methods.
  3. Enter the bank card details. You can also specify incorrect details (card number or expiration date) to test if an error is generated.
  4. Click Pay now.
Test cards list
See the list of test bank cards.
Note

In addition to card details, you need to specify the ZIP code if at least one of the following conditions is true:

  • The user’s country is the US or Canada.
  • The Bank Identification Number (BIN) indicates that a card was issued in the US.

You can specify any valid ZIP code (e.g., 12345). This determines the sales tax rate and does not affect the progress of the test payment.
Sandbox bank card payments can be made in the following currencies: USD, EUR, RUB, GBP, AED, ALL, AMD, ARS, AUD, AZN, BGN, BRL, BYN, CAD, CHF, CLP, CNY, COP, CZK, DKK, DZD, EGP, GEL, HKD, HRK, HUF, IDR, ILS, INR, ISK, JPY, KES, KGS, KRW, KZT, MAD, MDL, MKD, MNT, MXN, MYR, NGN, PEN, PHP, PKR, PLN, RON, RSD, SAR, SEK, SGD, THB, TRY, TWD, UAH, UYU, UZS, VEF, VND, ZAR.

To see transactions made in sandbox mode:

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

Refund

  1. Configure the Refund webhook.
  2. Make a successful test payment.
  3. Call the Request refund API method.

A notification about the payment refund will be sent to the webhook URL.

Partial refund

  1. Configure the Partial refund webhook.
  2. Make a successful test payment.
  3. Call the Request partial refund API method.

A notification about the partial payment refund will be sent to the webhook URL.

Blocking fraud transaction

  1. Configure the AFS rejected transaction webhook.
  2. Make a test payment with this card:

CardCountry3-D Secure
Card number: 5159084825528450
Exp. date: 12/40
CVV2: Any 3 digits
Card brand: Mastercard
USNo

When making this payment, you will see an error in the payment UI. A notification about a declined transaction as the result of the AFS check will also be sent to the webhook URL.

Chargeback

A separate API call for sandbox mode was developed to test this scenario without any bank participation.

To test chargeback:

  1. Configure the Refund webhook.
  2. Make a successful test payment.
  3. Call the Request chargeback API method.

You will receive a Refund webhook with the following code:

CodeReasonDescription
2ChargebackTransaction chargeback requested.

Test PayPal payment

Notice
Currently, testing PayPal payment is available only for a successful scenario.

  1. Create an account for PayPal sandbox mode:
    1. Open the PayPal Developer website.
    2. Log in to your account or create a new one.
    3. Go to Sandbox > Accounts.
    4. In the Sandbox Account section, click Create account.
    5. In the modal window, select the Personal account type and a country.
    6. Click Create. The created account will be shown in the list of sandbox accounts.

  1. Open the payment UI in sandbox mode.
  2. Choose the PayPal payment method.
  3. In the payment window, enter required information.
  4. Click Pay Now. You will be redirected to a window to log in to your PayPal account.

  1. To complete the testing payment process, enter information about your sandbox account created in step 1: Email ID as the email address and System Generated Password as the password. To find this information:
    1. Log in to your account on the PayPal Developer website.
    2. Go to Sandbox > Accounts.
    3. In the Sandbox Account section, choose the sandbox account.
    4. Click ••• and select View/edit account from the drop-down list.
  2. Click Pay Now.

You can also use information from existing sandbox accounts:

Email IDSystem Generated Password
sb-xmxij16980134@business.example.comoi9_m_KW
sb-p7pju16979920@business.example.com7%%p8ioS
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.
Rate this page
Rate this page
Is there anything we can improve?

Don’t want to answer

Thank you for your feedback!
Last updated: August 8, 2022

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!