JavaScript SDK для крипточекаута: запланировано и работает сегодня
JavaScript SDK для крипточекаута объяснён: запланированный скрипт, который открывает окно оплаты, что в дорожной карте Qvard и что работает сегодня.
JavaScript SDK для крипточекаута открывал бы окно оплаты несколькими строками кода на вашем сайте. Low-Code SDK у Qvard в дорожной карте и ещё не выпущен. Статья объясняет идею и показывает рабочий поток v1, которым можно пользоваться уже сейчас.
Что делает SDK для чекаута
SDK для чекаута — небольшая JavaScript-библиотека, которую подключает сайт, чтобы начать оплату. Она отрисовывает окно оплаты, проводит клиента по шагам и возвращает статус на страницу. Логика заказа остаётся на сервере мерчанта.
Статус: SDK в дорожной карте
Low-Code SDK от Qvard ещё не выпущен, и эта статья не описывает его как готовую библиотеку. Фрагмент ниже — предпросмотр запланированного вызова, а не код, который можно запустить сегодня.
Что работает сегодня
Создайте платёж на сервере запросом POST /api/v1/payment с заголовком x-api-key, перенаправьте клиента на возвращённый redirectUrl платёжной страницы и получите финальный статус по webhook. Это рабочий аналог запланированного вызова SDK.
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
}Вызов с сервера
Передайте номер заказа в id и цену в USD в price. Ключ API держите на сервере: в браузер приходит только redirectUrl, который вернул сервер.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });Запланированный вызов SDK
Ожидается, что SDK из дорожной карты откроет тот же платёжный поток с страницы одним вызовом. Имя метода и параметры могут измениться до релиза, поэтому под предпросмотр пока не пишите.
Как подготовиться
Держите создание платежа в одной функции бэкенда, а обработчик webhook — отдельно. Когда SDK выйдет, изменится только вызов на фронтенде; вызов сервера и webhook останутся прежними.
FAQ
Есть ли сегодня JavaScript SDK для чекаута от Qvard?
Нет. Low-Code SDK в дорожной карте. Сегодня тот же результат даёт API, платёжная страница и webhook.
Можно ли использовать вызов Qvardплатёжная страница.open() сейчас?
Нет. Он показан только как предпросмотр запланированного API. Используйте POST /api/v1/payment и перенаправление на redirectUrl.
Нужна ли JavaScript-библиотека, чтобы принимать крипту сегодня?
Нет. Достаточно обычной кнопки, которая вызывает бэкенд и перенаправляет на redirectUrl; подтверждает оплату webhook.
Как протестировать поток?
Создайте тестовый платёж и убедитесь, что webhook получает финальный статус.
