Оплата в один клик
Как это работает
Оплата в один клик позволяет пользователю использовать привычные и безопасные нативные способы, например, Apple Pay и Google Pay, на поддерживаемых устройствах. Эти платежные системы используют дополнительные механизмы защиты от нежелательных транзакций. Чтобы обеспечить простой и быстрый процесс оплаты, в некоторых случаях требуется дополнительная настройка на вашей стороне.
Сценарий пользователя при оплате в один клик:
- Пользователь переходит в платежный интерфейс для совершения оплаты.
- Пользователь нажимает кнопку оплаты с помощью одного из нативных способов.
- Пользователь переходит в свой электронный кошелек и выбирает карту для оплаты.
- Пользователь проходит проверку с помощью биометрии на своем устройстве.
- Пользователь возвращается в платежный интерфейс на страницу с успешным статусом платежа.
Apple Pay
Чтобы добавить в платежный интерфейс возможность оплаты в один клик с помощью Apple Pay:
- Создайте заявку на подключение этой опции. Для этого:
a. В Личном кабинете перейдите в раздел Support Hub.
b. Нажмите Отправить запрос.
c. В открывшемся окне заполните поля:
- Краткое описание. Например, Подключение оплаты в один клик.
- Описание. Укажите домен, по которому в вашем приложении открывается платежный интерфейс, например,
amazing.store.com
, и выберите способ оплаты в один клик: с помощью Apple Pay или Apple Pay и Google Pay. - ID проекта. Выберите ID проекта из раскрывающегося списка. Если вы хотите подключить оплату в один клик для нескольких проектов, укажите их ID в поле Описание.
d. Нажмите Отправить.
- Дождитесь получения верификационного файла для вашего домена. Этот шаг выполняется на стороне Xsolla:
- Xsolla регистрирует ваш домен на стороне Apple.
- Xsolla получает верификационный файл от Apple.
- Xsolla отправляет вам по электронной почте полученный верификационный файл и сообщает, по какому адресу его необходимо загрузить.
- В зависимости от способа открытия платежного интерфейса, выполните дополнительные настройки, описанные в таблице ниже.
- Сообщите Xsolla в ответном письме, что вы разместили верификационный файл по указанному адресу.
- Дождитесь подтверждения от Xsolla об успешной верификации вашего домена на стороне Apple.
Дополнительные настройки при открытии платежного интерфейса
Способ открытия платежного интерфейса | Дополнительные настройки |
---|---|
Новое окно | Дополнительных настроек не требуется. |
Iframe | Передайте ваш домен в query-параметре parent_domain , например, parent_domain=amazing.store.com , и добавьте атрибут allow=”payment” . |
Скрипт Pay Station Embed | Обновите скрипт до версии не ниже 1.5.0 и передайте ваш домен в query-параметре parent_domain , например, parent_domain=amazing.store.com .Скрипт версии 1.5.0 и выше поддерживает атрибут allow=”payment” по умолчанию. |
- html
<iframe src="https://secure.xsolla.com/paystation4/?token=token_body&parent_domain=amazing.store.com" allow="payment""></iframe>
Пример открытия платежного интерфейса с помощью скрипта Pay Station Embed:
- html
<script>
const options = {
access_token: 'PAYMENT_TOKEN',
lightbox: {
width: '800px',
height: '700px',
},
queryParams: {
parent_domain: 'amazing.store.com'
}
};
const s = document.createElement('script');
s.type = "text/javascript";
s.async = true;
s.src = "https://cdn.xsolla.net/payments-bucket-prod/embed/1.5.0/widget.min.js";
s.addEventListener('load', function (e) {
XPayStationWidget.init(options);
}, false);
const head = document.getElementsByTagName('head')[0];
head.appendChild(s);
</script>
Ограничения:
- Если в запросе на получение токена вы передаете параметр settings.ui.is_independent_windows, чтобы открыть платежный интерфейс в новой вкладке внешнего браузера, вы не сможете настроить оплату в один клик с помощью Apple Pay. Однако независимо от передачи этого параметра, вы можете принимать платежи через Apple Pay, открывая его в новой вкладке.
- Если вы используете SDK, вам необходимо использовать последнюю версию.
- Если вы используете скрипт Pay Station Embed, вам необходимо использовать последнюю версию (1.5.0 и выше).
Google Pay
Чтобы добавить в платежный интерфейс возможность оплаты в один клик с помощью Google Pay:
- В зависимости от способа открытия платежного интерфейса, выполните дополнительные настройки:
Способ открытия платежного интерфейса | Дополнительные настройки |
---|---|
Новое окно | Дополнительных настроек не требуется. |
Iframe | Добавьте атрибут allow=”payment” . |
Скрипт Pay Station Embed | Обновите скрипт до версии не ниже 1.5.0. Скрипт версии 1.5.0 и выше поддерживает атрибут allow=”payment” по умолчанию. |
Android WebView | Дополнительных настроек не требуется. |
Custom Tabs | Дополнительных настроек не требуется. |
- html
<iframe src="https://secure.xsolla.com/paystation4/?token=token_body" allow="payment""></iframe>
- Создайте заявку на подключение этой опции. Для этого:
a. В Личном кабинете перейдите в раздел Support Hub.
b. Нажмите Отправить запрос.
c. В открывшемся окне заполните поля:
- Краткое описание. Например, Подключение оплаты в один клик.
- Описание. Укажите ваш способ открытия платежного интерфейса и выберите способ оплаты в один клик: с помощью Google Pay или Google Pay и Apple Pay.
- ID проекта. Выберите ID проекта из раскрывающегося списка. Если вы хотите подключить оплату в один клик для нескольких проектов, укажите их ID в поле Описание.
d. Нажмите Отправить.
- Дождитесь письмо по электронной почте от Xsolla с подтверждением подключения оплаты в один клик в вашем проекте.
Ограничения:
- Если в запросе на получение токена вы передаете параметр settings.ui.is_independent_windows, чтобы открыть платежный интерфейс в новой вкладке внешнего браузера, вы не сможете настроить оплату в один клик с помощью Google Pay. Однако, независимо от передачи этого параметра, вы можете принимать платежи через Google Pay, открывая его в новой вкладке.
- Если вы используете скрипт Pay Station Embed, вам необходимо использовать последнюю версию (1.5.0 и выше).
- Игровые движки не поддерживают всплывающие окна, поэтому оплата в один клик с помощью Google Pay недоступна при использовании Xsolla SDK для Unity (кроме сборки WebGL) и Unreal Engine.
- В настоящее время для соблюдения бразильского законодательства, при оплате с помощью Google Pay пользователю необходимо вручную вводить свой налоговый номер (CPF). Из-за этого ограничения вы не сможете настроить оплату в один клик с помощью Google Pay для приема платежей в Бразилии.
- Для сборки WebGL в Unity, используйте последнюю версию SDK.
Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.