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