Set up item purchase

Create order on the server side of application

To create an order with user and item data on the Xsolla side, use the Create payment token for purchase API call. The method will return a payment token, which is required to open the payment UI and make a payment. To use sandbox mode, pass the “sandbox”: true parameter in the body of the request for getting a token.

Limitations:

• You need to pass either the user country or the user’s IP address when requesting the payment token. Using these data, the system determines the purchase currency, the language for localizing the payment interface and calculates taxes.
• If you don’t pass the currency in the token, it is determined by the country.
• If you pass the currency in the token, the user pays in this currency.
• In the user_id parameter you need to pass the user ID from your authentication system. This ID is used to validate the user before making a purchase. When testing, you can pass any symbol in this parameter.

Open payment UI

<script>
   var options = {
       access_token: 'ACCESS_TOKEN', //TODO use access token, received on previous step
       sandbox: true //TODO please do not forget to remove this setting when going live
   };
   var s = document.createElement('script');
   s.type = "text/javascript";
   s.async = true;
   s.src = "https://static.xsolla.com/embed/paystation/1.0.7/widget.min.js";
   s.addEventListener('load', function (e) {
       XPayStationWidget.init(options);
   }, false);
   var head = document.getElementsByTagName('head')[0];
   head.appendChild(s);
</script>

<button data-xpaystation-widget-open>Buy Credits</button>

<iframe
  src="https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN"
  width="800"
  height="700"
  allow="clipboard-read; clipboard-write; payment"
></iframe>

Make test payment

To test the payment process, you can use sandbox mode. Sandbox mode is a standalone environment that supports all features of a live environment, except real and declined payments. You can access sandbox mode by sending “sandbox”: true when you create an order.

1. Open the payment UI in sandbox mode.
2. Choose the Bank card payment method.
3. Enter the bank card details. In other fields (e.g., name or address), you can enter any data. You can also specify incorrect details (card number or expiration date) to test if an error is generated.
4. Click Pay.

Test cards list

See the list of test bank cards.

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.

Additionally, you can see the transactions’ details and request refunds in Publisher Account in the Support > Transaction search section.