Всплывающее окно криптоплатежа: как работает и что запланировано
Всплывающее окно криптоплатежа объяснено: как работает окно оплаты, что SDK Qvard планирует для него и что можно запустить сегодня. С кодом.
Всплывающее окно криптоплатежа — это окно оплаты, которое открывается поверх текущей страницы, так что клиент платит, не покидая сайт. Такое окно запланировано в составе SDK Qvard и ещё не выпущено. Статья объясняет, как оно работает и что уже сегодня можно запустить через API.
Как работает окно оплаты
Страница вызывает функцию, окно открывается поверх содержимого, клиент завершает оплату внутри и окно закрывается. Магазин остаётся на заднем плане, а заказ подтверждается на сервере.
Статус: окно в дорожной карте
Всплывающее окно Qvard ещё не выпущено, и статья не описывает его как готовую функцию. Код в медиа — предпросмотр запланированного вызова с пометкой roadmap.
Что работает сегодня
Создайте платёж запросом POST /api/v1/payment с заголовком x-api-key и перенаправьте клиента на redirectUrl платёжной страницы. Финальный статус получите по webhook. Так клиент получает тот же результат оплаты без всплывающего окна.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 149.99,
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Аккуратное открытие нового окна
Если нужно отдельное окно, открывайте redirectUrl в новой вкладке только после клика. Браузеры блокируют окна, открывающиеся без действия пользователя, поэтому клик должен быть первым.
Подтверждение оплаты на сервере
Окно, когда выйдет, будет показывать прогресс на странице, но статус оплаты всё равно должен приходить по webhook. Уже сейчас выстройте логику заказа вокруг webhook.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });Чего избегать
Не считайте закрытое окно неудачным платежом и не помечайте заказ оплаченным при закрытии окна. Дождитесь результата webhook.
FAQ
Есть ли сегодня всплывающее окно оплаты Qvard?
Пока нет. Окно запланировано в составе SDK из дорожной карты. Сегодня задачу решают платёжная страница или новая вкладка.
Может ли окно открыться без клика?
Браузеры обычно блокируют это. Открывайте платёжную страницу после клика пользователя.
Что если клиент закрыл окно?
Не решайте результат по событию закрытия. Проверьте статус заказа по webhook.
Как протестировать поток?
Создайте тестовый платёж и проверьте результат webhook.
