Payments / Токенизация
  На главную

Payments

Токенизация

Как это работает

Токенизация — набор методов API, позволяющих проводить безопасные платежи без открытия платежного интерфейса и непосредственного участия пользователя. Основные возможности:

  • получение списка сохраненных платежных аккаунтов;
  • проведение платежа;
  • удаление платежного аккаунта.

Сохранение платежных аккаунтов реализуется следующими способами:

  • При проведении платежа через платежный интерфейс Xsolla. Новый аккаунт добавляется, если пользователь на шаге ввода платежных реквизитов соглашается на их сохранение.
  • При открытии платежного интерфейса Xsolla в режиме сохранения платежных аккаунтов. Для реализации этого способа необходимо при получении токена передавать параметр settings.ui.mode.

Сохраненному платежному аккаунту присваивается ID. Укажите этот ID в запросе API, если хотите провести платеж без участия пользователя и открытия платежного интерфейса.

Способы оплаты, поддерживающие токенизацию:

  • банковские карты
  • Amazon Pay
  • Skrill Digital Wallet
  • PayPal
  • Alipay
  • GCash
  • DANA
  • Rabbit LINE pay
  • Touch ’n Go
  • Boost
  • Toss
  • PayPay
  • Paysafecard
  • TrueMoney Wallet

Как настроить

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

Совершение платежа по сохраненному платежному аккаунту

Чтобы совершить платеж по сохраненному платежному аккаунту без открытия платежного интерфейса, реализуйте в вашем приложении следующую логику совершения покупки:
  1. Получите список сохраненных платежных аккаунтов пользователя.
  2. Инициируйте оплату с помощью одного из полученных платежных аккаунтов.
  3. Обработайте информацию, полученную с помощью вебхука об успешном платеже, и зачислите пользователю покупку.
Внимание
Зачисление пользователю покупки должно осуществляться только на основании данных вебхука об успешном платеже.

Отображение сохраненных платежных аккаунтов на вашей стороне

С помощью запроса Список сохраненных платежных аккаунтов вы можете получать данные сохраненных платежных аккаунтов пользователя в обфусцированном виде на собственной странице оформления заказа.

Чтобы хранить обфусцированные данные сохраненных платежных аккаунтов на своей стороне и поддерживать их актуальность:

  1. Настройте прием вебхуков о добавлении платежного аккаунта. При получении информации о том, что пользователь добавил платежный аккаунт, вы можете сохранить его и в дальнейшем предлагать пользователю оплату покупок с помощью этого аккаунта без открытия платежного интерфейса.
  2. Настройте прием вебхуков об удалении платежного аккаунта.

Примечание
Для подключения вебхуков о добавлении и удалении платежного аккаунта обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

Обработка событий платежного интерфейса на странице управления сохраненными аккаунтами

Для отображения информации на странице управления сохраненными аккаунтами в режиме реального времени реализуйте обработку следующих событий платежного интерфейса:

  • add_saved_account — успешное сохранение платежного аккаунта.

Формат:

Copy
Full screen
Small screen
    command: "add_saved_account"
    data:
    id: 12345678
    name: "1111111111111111"
    payment_method: 0001
    type: "card"
    

    • add_saved_account_error — ошибка при сохранении платежного аккаунта.
    • cancel_save_account — отмена пользователем сохранения платежного аккаунта.

    События платежного интерфейса обрабатываются с помощью механизма postMessage, если платежный интерфейс открывается в iframe, или с помощью скрипта Pay Station Embed.

    Была ли статья полезна?
    Спасибо!
    Что может сделать страницу еще лучше? Сообщение
    Жаль, что так произошло
    Расскажите, почему статья не была полезна. Сообщение
    Спасибо за обратную связь!
    Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
    Оценить страницу
    Оценить страницу
    Что может сделать страницу еще лучше?

    В другой раз

    Спасибо за обратную связь!
    Последнее обновление: 10 октября 2023

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

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