Payments / Настройка покупки товара
  На главную

Payments

Настройка покупки товара

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

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

Ограничения:

  • Вам необходимо передать в запросе платежного токена либо страну, либо IP-адрес пользователя. Используя эти данные система определяет валюту покупки, язык для локализации платежного интерфейса и рассчитывает налоги.
  • Если вы не передали валюту при запросе платежного токена, она будет определяться согласно стране пользователя.
  • Если вы передали валюту при запросе платежного токена, пользователь будет оплачивать заказ в этой валюте.
  • В параметре user_id вам необходимо передать ID пользователя из вашей системы аутентификации. Этот ID использоваться для валидации пользователя перед совершением покупки. При тестировании вы можете передать в параметре любые символы.
Примечание
По умолчанию время жизни токена — 24 часа. Если вы хотите изменить это значение, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com. Новое значение будет действовать во всех проектах вашей компании, созданных в Личном кабинете.

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

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

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

Примечание

Тестирование платежей до подписания договора с Xsolla доступно только в тестовом окружении.

При совершении тестовой покупки с реальных счетов не списываются деньги.

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

Кроме реквизитов карты вам потребуется указать индекс, если выполняется хотя бы одно из условий:

  • Страна пользователя определена как США или Канада.
  • 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.

Внимание
В тестовом окружении вы можете протестировать разовую оплату и оплату сохраненными методами с помощью банковских карт и PayPal.
Чтобы увидеть транзакции, проведенные в тестовом окружении:
  1. Зайдите в свой аккаунт в Личном кабинете.
  2. Перейдите в раздел Финансы > Реестр транзакций.
  3. Установите флажок Показать тестовые транзакции.
Прогресс интеграции
Спасибо за обратную связь!
Последнее обновление: 4 сентября 2024

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!