Токенизация

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

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

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

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

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

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

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

• банковские карты
• AIS
• Alipay
• Amazon Pay
• au Easy Payment
• Boost
• DANA
• Docomo
• GCash
• K PLUS
• Maya
• Mercado Pago (включая Mercado Pago Connect)
• NuPay
• Paidy
• PayPal
• Paysafecard
• Rabbit LINE pay
• Skrill Digital Wallet
• SoftBank
• Toss
• Touch ’n Go
• TrueMoney Wallet
• Y!mobile
• Klarna

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

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

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

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

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

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

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

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

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

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

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

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

Формат:

1command: "add_saved_account"
2data:
3id: 12345678
4name: "1111111111111111"
5payment_method: 0001
6type: "card"

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

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