API для криптоплатежей: платежи сервер-сервер
Гайд по API для криптоплатежей: создайте платёж с сервера через POST /api/v1/payment, получите redirectUrl и финальный статус по webhook. Пример кода v1.
API для криптоплатежей позволяет вашему бэкенду создать платёж, отправить клиента на платёжную страницу и узнать финальный статус без собственной блокчейн-инфраструктуры. Qvard отдаёт этот сценарий как Host-to-Host API v1.
Что делает API для криптоплатежей
API для криптоплатежей превращает событие оформления заказа на вашем сервере в запрос на платёж. Бэкенд отправляет ваш номер заказа и сумму в вашей валюте (по умолчанию USD), а шлюз возвращает redirectUrl на платёжную страницу, где клиент выбирает актив и сеть. Адреса, курсы и мониторинг блокчейна остаются на стороне шлюза.
Как выглядит запрос v1
Вызов — один POST на /api/v1/payment с заголовком x-api-key. В поле id передаётся ваш номер транзакции, в price — сумма в валюте поля currency (ISO-4217, по умолчанию USD). платежиystemId необязателен и выбирает способ оплаты, если он нужен. В ответе приходят id платежа и redirectUrl.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR",
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Сервер-сервер, а не браузер-шлюз
Запрос делается с вашего бэкенда, поэтому ключ API никогда не попадает в браузер. Клиент видит платёжную страницу только после того, как вы перенаправите его туда. Заказ вы проверяете на своей стороне до создания платежа.
Финальный статус приходит по webhook
Ответ API подтверждает, что платёж создан, но не то, что он оплачен. Финальный статус доставляется на ваш webhook-URL методом POST с полями id и status, поэтому логика заказа должна опираться на webhook.
Что проверить перед запуском
Сохраняйте id платежа рядом с заказом, сделайте обработчик webhook безопасным при повторном вызове и пройдите весь сценарий на тестовом платеже. Используйте один и тот же id для заказа во всех запросах, чтобы повторные вызовы можно было сверить.
Комиссии и сети
Базовая ставка обработки — 1% за платёж, с ростом оборота она снижается индивидуально до 0,1%. Сетевая комиссия оплачивается отдельно в сети, которую выбрал клиент. Актуальные условия — на странице тарифов.
FAQ
Это то же самое, что платёжная ссылка?
Нет. Платёжная ссылка — это страница для ручных продаж, которой можно поделиться. API создаёт платёж из вашей системы и возвращает redirectUrl, которым управляет ваш код.
Нужно ли поднимать свою блокчейн-ноду?
Нет. Qvard мониторит сети и сообщает финальный статус по webhook, поэтому ноды и сканеры вы не запускаете сами.
В какой валюте указывается цена?
Поле price задаётся в валюте из поля currency (например, INR или EUR), без него — в USD. Клиент платит в том активе и сети, которые выбрал на платёжной странице.
Можно ли протестировать до запуска?
Да. Создайте тестовый платёж и посмотрите ту же платёжную страницу, которую увидят ваши клиенты.
