Платежи
без пауз.
Полная техническая спецификация для интеграции с Velox. Строгий REST API, детальные логи и SDK для основных языков программирования.
Введение и аутентификация
Velox API использует стандартные HTTP-заголовки для аутентификации. Для доступа к платежным методам вам потребуется API Key и Secret Key, которые генерируются в личном кабинете в разделе Настройки / Разработчики.
Все запросы должны быть отправлены на базовый URL:
https://api.velox.ru/v2
Токен доступа передается в заголовке Authorization с префиксом Bearer. Срок жизни токена — 24 часа.
Authorization: Bearer vk_live_58a92b...
Эндпоинты платежей
/payments
Создание нового платежа. Принимает JSON с полями amount, currency, receiver_account и purpose. Возвращает payment_id и статус pending.
/payments/{id}
Проверка статуса транзакции. Используется для получения актуального состояния платежа: success, failed или processing.
/payments/{id}/cancel
Отмена платежа. Доступна только для транзакций в статусе pending. Средства возвращаются на счет инициатора мгновенно.
Webhooks
Не опрашивайте API в цикле. Velox отправляет уведомления о критических событиях на ваш X-Callback-Url. Мы гарантируем доставку (At-least-once delivery).
-
●
payment.succeeded— платеж зачислен -
●
payment.failed— ошибка транзакции -
●
balance.low— низкий остаток на счете
{
"event": "payment.succeeded",
"id": "evt_123456",
"data": {
"payment_id": "pay_987654",
"amount": 150000.00,
"currency": "RUB",
"timestamp": "2023-10-27T10:00:00Z"
},
"signature": "sha256:..."
}Библиотеки SDK
Мы поддерживаем разработчиков, предоставляя нативные библиотеки для популярных языков. Это ускоряет интеграцию и помогает избежать ошибок при формировании подписей.
Нужна помощь с интеграцией?
Наша команда техподдержки доступна 24/7 в Slack и Telegram. Поможем разобраться с вебхуками и песочницей.