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