Настройка покупки товара
Создание заказа на серверной части приложения
Чтобы на стороне Xsolla сформировать заказ с данными о пользователе и товаре, используйте метод API Создание платежного токена для покупки. Метод вернет платежный токен, который потребуется для открытия платежного интерфейса и совершения оплаты. Чтобы получить доступ к тестовому окружению, передайте параметр “sandbox”: true
.
Ограничения:
- Вам необходимо передать в запросе платежного токена либо страну, либо IP-адрес пользователя. Используя эти данные система определяет валюту покупки, язык для локализации платежного интерфейса и рассчитывает налоги.
- Если вы не передали валюту при запросе платежного токена, она будет определяться согласно стране пользователя.
- Если вы передали валюту при запросе платежного токена, пользователь будет оплачивать заказ в этой валюте.
- В параметре
user_id
вам необходимо передать ID пользователя из вашей системы аутентификации. Этот ID использоваться для валидации пользователя перед совершением покупки. При тестировании вы можете передать в параметре любые символы.
Открытие платежного интерфейса
Совершение тестового платежа
Для тестирования процесса оплаты вы можете использовать тестовое окружение (sandbox-режим). Тестовое окружение — это автономная рабочая среда, в которой доступны все функции live-режима, кроме проведения реальных платежей и отмены платежей. Чтобы получить доступ к тестовому окружению, передайте параметр “sandbox”: true
при создании заказа.
Тестирование платежей до подписания договора с Xsolla доступно только в тестовом окружении.
При совершении тестовой покупки с реальных счетов не списываются деньги.
- Откройте платежный интерфейс в тестовом окружении.
- Выберите способ оплаты Карта банка.
- Введите реквизиты карты. Остальные поля (например, имя или адрес) могут быть заполнены любыми данными. Вы также можете указать неверные реквизиты (номер карты или срок действия) для генерации ошибки.
- Нажмите Оплатить.
Кроме реквизитов карты вам потребуется указать индекс, если выполняется хотя бы одно из условий:
- Страна пользователя определена как США или Канада.
- ID карты (БИН) указывает на то, что карта выпущена в США.
Вы можете указать произвольное числовое значение в качестве индекса (например, 12345). Он используется для определения ставки налога на продажу и не влияет на прохождение тестового платежа.
Платежи банковской картой в тестовом окружении могут проводиться в следующих валютах: 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.
Чтобы увидеть подробную информацию, включая комиссии, о транзакциях, проведенных в тестовом окружении:
- Откройте Личный кабинет.
- Перейдите в раздел Финансы > Реестр транзакций.
- Установите флажок Показать тестовые транзакции.
Кроме этого, детали транзакции и оформление возврата доступны в Личном кабинете в разделе Поддержка > Поиск транзакций.
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.