Что такое host-to-host шлюз платежей?
Что такое host-to-host шлюз платежей: платежи сервер-сервер с редиректом на платёжную страницу и финальным webhook. Объясняем для мерчантов.
Host-to-host шлюз платежей соединяет ваш сервер напрямую с платёжным провайдером. Бэкенд создаёт платежи, клиент платит на платёжной странице, а провайдер возвращает результат на ваш сервер.
Что означает host-to-host
В модели host-to-host запрос на платёж идёт с вашего сервера на шлюз, а не из браузера. Клиент видит шлюз только на платёжной странице, а ключи и логика заказа остаются у вас.
Как работает поток
Ваш сервер создаёт платёж запросом POST /api/v1/payment, получает redirectUrl, отправляет клиента туда и получает финальный статус по webhook. Три шага покрывают весь поток.
Для кого это
Интернет-магазины, SaaS-продукты и маркетплейсы, у которых уже есть бэкенд и которые хотят полного контроля над логикой оплаты, статусами заказов и сверкой.
Платёжная страница и фиксированный курс
Клиент платит на платёжной странице Qvard, где точная сумма выбранного актива и сети фиксируется на время жизни счёта. Генерация адресов и логика курсов вам не нужны.
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
}Базовая безопасность
Храните x-api-key на сервере, проверяйте заголовок x-api-key в каждом webhook и принимайте только HTTPS-endpoint. Редирект — это навигация, а не подтверждение оплаты.
Когда подойдёт другой продукт
Без бэкенда проще платёжная ссылка. Встроенный чекаут, SDK, терминал и Telegram-оплата — в планах; сегодня тот же результат даёт API и платёжная страница.
FAQ
Host-to-host — это то же самое, что API?
Это модель на основе API, в которой сервер напрямую обращается к шлюзу. Термин описывает, кто делает вызов, то есть сервер, а не отдельный протокол.
Нужен ли отдельный сервер?
Нет. Достаточно любого бэкенда, который умеет делать HTTPS-запросы и открывает webhook-URL.
Сколько стоит шлюз?
Базовая ставка — 1% за платёж, индивидуальные ставки снижаются до 0,1% с ростом оборота, сетевые комиссии оплачиваются отдельно.
Можно ли сочетать host-to-host с платёжной страницей?
Да, это стандартный поток: API создаёт платёж, а платёжная страница принимает оплату.
