API для приёма платежей
Выставляйте счета в криптовалюте через API, отправляйте клиента на платёжную страницу и получайте финальные статусы через webhook.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR"
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}API Qvard для разработчиков
- Создание платежа и получение redirectUrl
- Обработка финального webhook-статуса
- successUrl, failUrl и returnUrlСкоро
x-api-key: sk_live_…
{
"id": "order_1024",
"status": "paid"
}1 запрос, 1 редирект, 1 webhook
Создайте платёж, перенаправьте клиента и обработайте финальный webhook — вся интеграция умещается на одной странице.
Создайте платёж с externalId, суммой, валютой и URL.
Перенаправьте клиента на data.redirectUrl.
Получите финальный webhook со статусом wait, processing, completed или rejected.
Платите в своей валюте, учёт в USD
Задайте сумму в любой валюте ISO-4217 полем currency, например INR, RUB или EUR. Без него сумма указывается в USD, как и раньше.
- Курс Qvard фиксируется один раз, при создании платежа. Плательщик видит сумму в вашей валюте и сумму в токене, которым платит; платёж учитывается в USD.
- Лимиты проверяются в USD после конвертации. Если сумма выходит за пределы, в тексте ошибки лимит показан в вашей валюте.
- Текущие курсы — на странице курсов и в API: GET /api/v1/rates, ключ не нужен. В настройках магазина можно задать свой курс по каждой валюте.
- Ошибки: 422 unsupported_currency — валюта не поддерживается; 422 rate_unavailable — нет курса; 422 invalid_amount_precision — знаков после запятой больше, чем у валюты (JPY 0, KWD 3, большинство валют 2).
curl "https://api.qvard.com/api/v1/rates?currencies=EUR,INR"
// 200 OK
{ "data": { "base": "USD", "updatedAt": "…", "rates": { "EUR": 0.92, "INR": … } } }Проверяйте подпись вебхука
Каждый вебхук Qvard подписан HMAC-SHA256. Узнайте, как проверить подпись и защититься от подделки, с готовым кодом для Node.js и PHP.
Вопросы и ответы
Коротко о том, как Qvard закрывает оплату, интеграцию и операционные процессы мерчанта.
Что такое Qvard?
Qvard даёт бизнесу готовый платёжный слой: клиент оплачивает через понятную страницу, а мерчант получает статусы, балансы и инструменты для вывода.
Какие активы поддерживаются?
Витрина уже показывает USDT, USDC, BTC, LTC, TRX, BNB и ETH. Для USDT доступны разные сети, чтобы клиент мог выбрать привычный маршрут оплаты. TON и USDT TON — скоро.
Подходит ли Qvard разработчикам?
Да. Интеграция строится вокруг создания платежа, редиректа на redirectUrl и финального webhook-статуса, чтобы заказ в вашей системе обновлялся автоматически.
Можно ли кастомизировать платёжную страницу?
Да. Можно адаптировать название магазина, логотип, визуальный стиль и тексты, чтобы платёжная страница выглядела частью вашего продукта. URL возврата (successUrl/failUrl) — скоро.
Что нужно, чтобы начать?
Создайте аккаунт мерчанта и пройдите проверку бизнеса. Протестировав тестовый платёж, подключите платёжную страницу или API и начните принимать реальные платежи.
Как работает вывод средств?
Средства учитываются на балансах мерчанта отдельно по активам и сетям. Выводить можно вручную или настроить правила автоматического вывода.