Test saved cards 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}.

Notice
Currently, testing tokenization is only available for scenarios with bank card payments.

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

Note
Scenarios for testing one-time purchase in the sandbox mode are also applied to testing tokenization.

Save card

You can test saving a card by two ways:

Saving card while making a test payment

  1. Configure the Add payment account webhook.
  2. Open the payment UI in sandbox mode.
  3. Choose the Credit/Debit cards group of payment methods.
  4. Enter the bank card details. You can also specify incorrect details (card number or expiration date) to test if an error is generated.
  5. Check the Save this card for future payments box.
  6. Click Pay now.
Test cards list
See the list of test bank cards.

A notification about adding a new card will be sent to the webhook URL.
Saved card will be displayed in the Payment accounts section.

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.

Saving card from a user account

  1. Configure the Add payment account webhook.
  2. Open the payment UI in sandbox mode.
  3. Go to My payment accounts.
  4. Click Add account.
  5. Choose the Credit/Debit cards group of payment methods.
  6. Enter the bank card details. You can also specify incorrect details (card number or expiration date) to test if an error is generated.
  7. Click Save.

A notification about adding a new card will be sent to the webhook URL.
Saved card will be displayed in the Payment accounts section.

Delete saved card

You can test deleting a saved card by two ways:

Deleting saved card via API

  1. Configure the Remove payment account webhook.
  2. Call the Delete saved accounts API method.

A notification about deleting a card will be sent to the webhook URL.

Deleting saved card in payment UI

  1. Configure the Remove payment account webhook.
  2. Open the payment UI in sandbox mode.
  3. Go to My payment accounts.
  4. Choose a card and click Delete.

A notification about deleting a card will be sent to the webhook URL.

Charge with saved card

You can test a payment with a saved card in the following ways:

Note
You can test both a one-time charge (e.g., purchase with a saved card) and regular charges (e.g., subscription payment).

Charging with saved card via API

  1. Configure the Payment webhook.
  2. Save card in the sandbox mode.
  3. Call the Charge with saved account API method.

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

Charging with saved card in the payment UI

  1. Configure the Payment webhook.
  2. Save card in the sandbox mode.
  3. Open the payment UI in sandbox mode.
  4. Click the card from the list of saved payment accounts.
  5. Click Proceed to checkout.
  6. If needed, enter CVV.
  7. Click Pay now.

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

Get list of saved cards

  1. Save cards in the sandbox mode.
  2. Call the Get saved accounts API method.

You will get masked data in the response.

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!