Крипто-терминал для оплаты: что это и что работает сегодня
Крипто-терминал для оплаты объяснён: кассовое устройство для криптоплатежей, что в дорожной карте Qvard и что уже работает через API. Пошагово.
Крипто-терминал для оплаты — это кассовое устройство, которое принимает криптоплатежи у прилавка. Терминал Qvard находится в дорожной карте и ещё не выпущен. Статья объясняет идею и рабочий путь: сервер кассы создаёт платежи через живой API v1.
Что делает крипто-терминал
Крипто-терминал показывает сумму, позволяет клиенту заплатить кошельком и подтверждает результат на экране. Он заменяет картридер для бизнеса, который хочет принимать крипту у физического прилавка.
Статус: терминал в дорожной карте
POS-терминал Qvard ещё не выпущен, и статья не описывает его как готовое устройство. Рабочий путь ниже доступен сегодня через API, платёжную страницу и webhook.
Что работает сегодня
Сервер кассы создаёт платёж запросом POST /api/v1/payment с заголовком x-api-key и получает redirectUrl. Клиент платит на платёжной странице, на которую указывает 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
}Вызов сервера кассы
Передайте номер продажи в id и сумму в USD в price. Ключ API держите на сервере кассы. Ответ возвращает redirectUrl, который касса показывает клиенту.
Подтверждение продажи по webhook
Касса должна помечать продажу оплаченной только после того, как webhook передаст id и статус paid. До этого продажа остаётся в ожидании, даже если клиент говорит, что уже заплатил.
Как подготовиться к отдельному терминалу
Держите логику продаж и webhook в ПО кассы. Когда выйдет отдельный терминал, поменяется устройство, а создание платежа и обработка статусов останутся прежними.
FAQ
Есть ли сегодня крипто-терминал Qvard?
Пока нет. POS-терминал в дорожной карте. Сегодня сервер кассы использует API, платёжную страницу и webhook.
Можно ли использовать своё ПО кассы?
Да. Любое ПО, которое умеет отправлять HTTPS POST и принимать webhook, может создавать платежи через API.
Что видит клиент у прилавка?
Сегодня касса показывает redirectUrl как QR-код или ссылку, а платёжная страница открывается на устройстве клиента.
Как протестировать до реальной продажи?
Создайте тестовый платёж, оплатите его на платёжной странице и проверьте, что webhook отмечает продажу.
