Voucher Pay
Оплата на платёжной странице в EUR и USD с фиксированными номиналами
Перед тем как начать
Авторизация
Как подписывать запросы API-токеном.
Создание платежа
Базовый запрос на создание заказа, который расширяет эта страница.
Этот способ оплаты доступен не всем мерчантам. Уточните доступность у вашего менеджера.
Обзор
Voucher Pay использует стандартный эндпоинт создания платежа. Перенаправьте плательщика на paymentLink из ответа: оплату он завершает на платёжной странице.
| Параметр | Поддерживаемые значения |
|---|---|
| Валюта | EUR, USD |
| Сумма | 5, 10, 15, 25, 30, 50, 100 |
| Данные плательщика | Дополнительные поля customer для этого способа не требуются |
| Сценарий оплаты | Платёжная страница; передача карты через H2H не поддерживается |
Запросите у менеджера подключение Voucher Pay и соответствующий serviceId. Передавать extraParams, данные карты или отдельный API-ключ провайдера не нужно.
Ограничения суммы
Сумма, передаваемая на оплату, должна точно соответствовать одному из номиналов. Например, 10.00 подходит, а 11.00 и 10.50 — нет. Номиналы одинаковы для обеих валют.
Перенос комиссии на плательщика может изменить сумму к оплате, и она перестанет соответствовать номиналу. Согласуйте с менеджером настройки комиссии, при которых итоговая сумма останется допустимой.
Пример запроса
Вместо значения 3 из примера передайте serviceId, выданный для этого способа оплаты.
curl -X POST "https://api.panel.valutix.kz/v1/orders" \
-H "Content-Type: application/json" \
-H "X-Api-Token: YOUR_API_TOKEN" \
-d '{
"amount": "10.00",
"currency": "EUR",
"serviceId": 3,
"externalId": "order_12345",
"isFeeOnUser": false,
"successUrl": "https://example.com/success",
"callbackUrl": "https://example.com/webhooks/payments"
}'Ответ и результат оплаты
В ответе возвращается стандартный объект заказа. Перенаправьте плательщика на его paymentLink.
В ответе возвращается стандартный объект заказа. Заказ создаётся со статусом CREATED; перенаправьте плательщика на paymentLink, чтобы он завершил оплату.
Поля объекта заказа
Оплату подтверждает только статус заказа COMPLETED. Получайте результат через стандартный webhook заказа или эндпоинт статуса. Подпись webhook и формат статусов заказа для этого способа не меняются.
Возврат с платёжной страницы
Адрес возврата задаётся при подключении способа оплаты и должен использовать HTTPS-домен, согласованный с провайдером. Попросите менеджера настроить его: платёжная страница использует этот адрес вместо successUrl или failUrl заказа.
successUrl по-прежнему обязателен в запросе или настройках мерчанта по общему контракту создания заказа, хотя он не передаётся этой платёжной странице.
Возврат на ваш сайт не подтверждает оплату. Проверьте статус заказа перед выдачей товара или услуги.