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

Вы можете продавать как товар с одним артикулом в любом количестве, так и корзину товаров с разными артикулами, которую предварительно наполнил пользователь. Чтобы на стороне Xsolla сформировать заказ с данными о пользователе и товарах, используйте один из следующих методов API:

• Создание заказа с указанным товаром
• Создание заказа со всеми товарами из текущей корзины
• Создание заказа со всеми товарами из определенной корзины

Вызванный метод 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, вызовите метод XsollaCatalog.Purchase из библиотеки Store, передав в него следующие параметры:

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

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

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

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

Для тестирования процесса оплаты вы можете использовать тестовое окружение (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 — параметры оплаты (опционально).

1. • 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")
        }
    }
}

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

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

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

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

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

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

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

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

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

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

Вы можете продавать как товар с одним артикулом в любом количестве, так и корзину товаров с разными артикулами, которую предварительно наполнил пользователь.

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

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.

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

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

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

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

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

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

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

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

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