One-click payment

How it works

One-click payment allows users to pay with familiar and secure native payment methods, e.g., Apple Pay and Google Pay, on supported devices. These payment systems employ additional security mechanisms to prevent unauthorized transactions. To ensure a fast and seamless payment process, additional configuration may be required on your side.

User flow when paying in one click:

1. The user goes to the payment UI to make a purchase.
2. The user clicks a button to pay with one of the native methods.
3. The user is redirected to their electronic wallet and selects a card for payment.
4. The user passes authentication procedure with on-device biometrics.
5. The user returns to the payment UI that displays the successful payment status.

Apple Pay

To add an option for one-click payment via Apple Pay to the payment UI:

1. Create a request to enable this option. To do so:

   a. Open your Publisher Account and go to the Support Hub section.

   b. Click Submit request.

   

   c. In the window that opens, fill in the fields:

   • Summary. For example, One-click payment setup.
   • Description. Specify the domain used for opening the payment UI, e.g., amazing.store.com and indicate a one-click payment option: via Apple Pay or both Apple Pay and Google Pay.
   • Project ID. Select a project ID from the drop-down list. If you want to configure the one-click payment option for multiple projects, specify their IDs in the Description field.

   d. Click Send.

2. Wait for your domain association file. This step is performed by Xsolla:
   1. Xsolla registers your domain with Apple.
   2. Xsolla receives the domain association file from Apple.
   3. Xsolla emails you the domain association file and provides instructions on where to upload it.
3. Depending on the way you open the payment UI, complete the additional configurations described in the table below.
4. Reply to Xsolla email and confirm that you have uploaded the domain association file to the specified location.
5. Wait for confirmation from Xsolla regarding the successful verification of your domain with Apple.

Additional configurations for opening the payment UI

<iframe src="https://secure.xsolla.com/paystation4/?token=token_body&parent_domain=amazing.store.com" allow="payment""></iframe>

Example of the payment UI opening with the Pay Station Embed script:

<script>
        const options = {
            access_token: 'PAYMENT_TOKEN',
            lightbox: {
                width: '800px',
                height: '700px',
            },
            queryParams: {
                parent_domain: 'amazing.store.com'
            }
        };
        const s = document.createElement('script');
        s.type = "text/javascript";
        s.async = true;
        s.src = "https://cdn.xsolla.net/payments-bucket-prod/embed/1.5.0/widget.min.js";
        s.addEventListener('load', function (e) {
            XPayStationWidget.init(options);
        }, false);

        const head = document.getElementsByTagName('head')[0];
        head.appendChild(s);
</script>

Limitations:

• If you pass the settings.ui.is_independent_windows parameter in the token request to open the payment UI in a new tab of an external browser, you can’t enable one-click payment via Apple Pay. However, regardless of whether this parameter is passed, you can accept payments via Apple Pay by opening it in a new tab.
• If you use the SDK, ensure you use the latest version.
• If you use the Pay Station Embed script, it must be the version 1.5.0 or later.

Google Pay

To add an option for one-click payment via Google Pay to the payment UI:

1. Depending on the way you open the payment UI, complete the additional configurations:

<iframe src="https://secure.xsolla.com/paystation4/?token=token_body" allow="payment""></iframe>

2. Create a request to enable this option. To do so:

   a. Open your Publisher Account and go to the Support Hub section.

   b. Click Submit request.

   

   c. In the window that opens, fill in the fields:

   • Summary. For example, One-click payment setup.
   • Description. Specify the way you open the payment UI and indicate a one-click payment option: via Google Pay or both Google Pay and Apple Pay.
   • Project ID. Select a project ID from the drop-down list. If you want to configure the one-click payment option for multiple projects, specify their IDs in the Description field.

   d. Click Send.

3. Wait for confirmation from Xsolla regarding the successful enabling of the one-click payment option in your project.

Limitations:

• If you pass the settings.ui.is_independent_windows parameter in the token request to open the payment UI in a new tab of an external browser, you can’t enable one-click payment via Google Pay. However, regardless of whether this parameter is passed, you can accept payments via Google Pay by opening it in a new tab.
• If you use the Pay Station Embed script, it must be the version 1.5.0 or later.
• Game engines do not support pop-up windows. That is why Google Pay one-click payment is unavailable when using Xsolla SDK for Unity (except for WebGL builds) and Unreal Engine.
• To comply with Brazilian legislation, users have to manually enter their tax identification number (CPF) when paying with Google Pay. That is why Google Pay one-click payment can’t be enabled to accept payments in Brazil.
• For WebGL builds in Unity, ensure you use the latest SDK version.