Создание заказа в клиентской части приложения

Чтобы на стороне Xsolla сформировать заказ с данными о пользователе и товаре, используйте метод API Создание заказа с указанным товаром. Метод вернет платежный токен, который потребуется для открытия платежного интерфейса и совершения оплаты. Чтобы получить доступ к тестовому окружению, передайте параметр “sandbox”: true.

Открытие платежного интерфейса

<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>

Совершение тестового платежа

Для тестирования процесса оплаты вы можете использовать тестовое окружение (sandbox-режим). Тестовое окружение — это автономная рабочая среда, в которой доступны все функции live-режима, кроме проведения реальных платежей и отмены платежей. Чтобы получить доступ к тестовому окружению, передайте параметр “sandbox”: true при создании заказа.

1. Откройте платежный интерфейс в тестовом окружении.
2. Выберите способ оплаты Карта банка.
3. Введите реквизиты карты. Остальные поля (например, имя или адрес) могут быть заполнены любыми данными. Вы также можете указать неверные реквизиты (номер карты или срок действия) для генерации ошибки.
4. Нажмите Оплатить.

Список тестовых карт

Посмотрите список тестовых банковских карт.

Чтобы увидеть подробную информацию, включая комиссии, о транзакциях, проведенных в тестовом окружении:

1. Откройте Личный кабинет.
2. Перейдите в раздел Финансы > Реестр транзакций.
3. Установите флажок Показать тестовые транзакции.

Кроме этого, детали транзакции и оформление возврата доступны в Личном кабинете в разделе Поддержка > Поиск транзакций.

Создание заказа и открытие платежного интерфейса

Чтобы сформировать заказ с данными о пользователе и товаре на стороне Xsolla, вызовите метод SDK XsollaCatalog.Purchase, передав в него следующие параметры:

• itemSku — артикул товара, который пользователь хочет приобрести.
• onSuccess — обработчик, вызываемый после того, как заказ перейдет в статус done.
• onError — обработчик, вызываемый в случае ошибки запроса.
• onBrowseClosed — обработчик, вызываемый после закрытия браузера (опционально). Событие отслеживается только при открытии пользовательского интерфейса оплаты во встроенном браузере. События внешнего браузера не отслеживаются.
• purchaseParams — параметры покупки и пользовательского интерфейса оплаты, такие как локаль и валюта (опционально).
• customHeaders — пользовательские заголовки веб-запроса (опционально).

Метод XsollaCatalog.Purchaseзапускает процесс покупки для указанного товара, включая создание заказа, открытие пользовательского интерфейса оплаты и отслеживание статуса заказа. Передайте в параметре onSuccess функцию, которая вызывается в случае перехода заказа в статус done.

Совершение тестового платежа

Для тестирования процесса оплаты вы можете использовать тестовое окружение (sandbox-режим). Тестовое окружение — это автономная рабочая среда, в которой доступны все функции live-режима, кроме проведения реальных платежей и отмены платежей. Чтобы иметь доступ к тестовому окружению, в редакторе Unity у вас должен быть установлен флажок Test Payments Mode в панели Inspector (установлен по умолчанию).

1. Запустите ваше приложение или сцену в редакторе Unity.
2. Выберите способ оплаты Карта банка.
3. Введите реквизиты карты. Остальные поля (например, имя или адрес) могут быть заполнены любыми данными. Вы также можете указать неверные реквизиты (номер карты или срок действия) для генерации ошибки.
4. Нажмите Оплатить.

Список тестовых карт

Посмотрите список тестовых банковских карт.

Чтобы увидеть подробную информацию, включая комиссии, о транзакциях, проведенных в тестовом окружении:

1. Откройте Личный кабинет.
2. Перейдите в раздел Финансы > Реестр транзакций.
3. Установите флажок Показать тестовые транзакции.

Кроме этого, детали транзакции и оформление возврата доступны в Личном кабинете в разделе Поддержка > Поиск транзакций.

Создание заказа и открытие платежного интерфейса

1. Чтобы сформировать заказ с данными о пользователе и товаре на стороне Xsolla, вызовите метод createOrderByItemSku из библиотеки Store, передав в него следующие параметры:

1. • callback — обработчик, вызываемый после успешного формирования заказа. В этот обработчик будет передан платежный токен, необходимый для открытия платежного интерфейса и оплаты.

1. • itemSku — артикул товара, который пользователь хочет приобрести.

1. • options — параметры оплаты (опционально).

quantity — количество товаров, которое пользователь хочет приобрести (опционально). Если количество не указано, по умолчанию будет установлено значение 1.

2. Реализуйте открытие платежного интерфейса:

val intent = XPayments.createIntentBuilder(activity)
    .accessToken(AccessToken(<payment token>))
    .isSandbox(<isSandbox>)
    .build()
startActivityForResult(intent, RC_PAYSTATION)

3. Реализуйте обработку результата платежа:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == RC_PAYSTATION) {
        val (status, _) = XPayments.Result.fromResultIntent(data)
        when (status) {
            XPayments.Status.COMPLETED -> Log.d("MainActivity", "Payment completed")
            XPayments.Status.CANCELLED -> Log.d("MainActivity", "Payment cancelled")
            XPayments.Status.UNKNOWN -> Log.d("MainActivity", "Status unknown")
        }
    }
}

Совершение тестового платежа

Для тестирования процесса оплаты вы можете использовать тестовое окружение (sandbox-режим). Тестовое окружение — это автономная рабочая среда, в которой доступны все функции live-режима, кроме проведения реальных платежей и отмены платежей. Для доступа к тестовому окружению при создании объекта IntentBuilder вызовите метод isSandbox и передайте true в качестве аргумента.

1. Запустите ваше приложение.
2. Выберите способ оплаты Карта банка.
3. Введите реквизиты карты. Остальные поля (например, имя или адрес) могут быть заполнены любыми данными. Вы также можете указать неверные реквизиты (номер карты или срок действия) для генерации ошибки.
4. Нажмите Оплатить.

Список тестовых карт

Посмотрите список тестовых банковских карт.

Чтобы увидеть подробную информацию, включая комиссии, о транзакциях, проведенных в тестовом окружении:

1. Откройте Личный кабинет.
2. Перейдите в раздел Финансы > Реестр транзакций.
3. Установите флажок Показать тестовые транзакции.

Кроме этого, детали транзакции и оформление возврата доступны в Личном кабинете в разделе Поддержка > Поиск транзакций.

Создание заказа и открытие платежного интерфейса

1. Чтобы сформировать заказ с данными о пользователе и товаре на стороне Xsolla, вызовите метод SDK FetchPaymentToken, передав в него следующие параметры:

1. • AuthToken — токен авторизации пользователя, полученный во время авторизации с использованием Xsolla Login.

1. • ItemSKU — артикул товара, который пользователь хочет приобрести.

1. • SuccessCallback — обработчик, вызываемый после успешного получения платежного токена.

1. • ErrorCallback — обработчик, вызываемый в случае ошибки запроса.

1. • PurchaseParams — параметры покупки и пользовательского интерфейса оплаты, например, локаль и валюта (опционально).

2. Реализуйте открытие платежного интерфейса. Для этого вызовите метод SDK LaunchPaymentConsole и передайте в него следующие параметры:

1. • WorldContextObject — объект, который предоставляет контекст игрового мира (для вызова C++).

1. • OrderId — ID заказа.

1. • AccessToken — платежный токен.

1. • SuccessCallback — обработчик, вызываемый после успешного завершения платежа.

1. • ErrorCallback — обработчик, вызываемый в случае ошибки запроса.

1. • BrowserClosedCallback — обработчик, вызываемый после закрытия браузера. Событие отслеживается только при открытии пользовательского интерфейса оплаты во встроенном браузере. События внешнего браузера не отслеживаются.

1. • PayStationVersion — версия Pay Station. По умолчанию используется версия 4.

Совершение тестового платежа

Для тестирования процесса оплаты вы можете использовать тестовое окружение (sandbox-режим). Тестовое окружение — это автономная рабочая среда, в которой доступны все функции live-режима, кроме проведения реальных платежей и отмены платежей. Чтобы иметь доступ к тестовому окружению, в Unreal Editor у вас должен быть установлен флажок Enable Sandbox в разделе Settings > Project Settings > Plugins > Xsolla Settings > Purchases(установлен по умолчанию).

1. Запустите ваше приложение или карту в Unreal Editor.
2. Выберите способ оплаты Карта банка.
3. Введите реквизиты карты. Остальные поля (например, имя или адрес) могут быть заполнены любыми данными. Вы также можете указать неверные реквизиты (номер карты или срок действия) для генерации ошибки.
4. Нажмите Оплатить.

Список тестовых карт

Посмотрите список тестовых банковских карт.

Чтобы увидеть подробную информацию, включая комиссии, о транзакциях, проведенных в тестовом окружении:

1. Откройте Личный кабинет.
2. Перейдите в раздел Финансы > Реестр транзакций.
3. Установите флажок Показать тестовые транзакции.

Кроме этого, детали транзакции и оформление возврата доступны в Личном кабинете в разделе Поддержка > Поиск транзакций.