API. Подключение
На этой странице
API VEPAY позволяет полностью управлять платёжным процессом из вашего кода: создание транзакций, оплата по токену, выплаты, возвраты и получение статусов. Обмен данными — JSON over HTTPS, авторизация — по заголовку с идентификатором пользователя (X-User) и ключу доступа.
Базовые принципы
- Все запросы выполняются методом POST к домену платёжного шлюза VEPAY
- Тело запроса — JSON в UTF-8; ответ также JSON
- Идентификаторы транзакций: vepayid присваивается платформой, extid — ваш внешний идентификатор
- Асинхронная обработка: статус операции поступает через вебхук или запрашивается через API
- Ошибка 5xx означает, что транзакция не попала в обработку — повторите запрос
Типовой сценарий оплаты
1. POST /transaction → создаётся платёж, возвращает URL формы
2. Редирект покупателя на URL формы VEPAY
3. Покупатель вводит данные карты, 3-D Secure
4. Webhook на ваш endpoint: статус платежа
5. GET /transaction/{vepayid} → контроль статусаПолный справочник методов с параметрами предоставляется в личном кабинете после создания тестового доступа. Ключевые сервисы описаны в разделах «Наши сервисы».
Тестовые карты
В тестовой среде используйте специальные номера карт: успешный платёж, отказ банка и прохождение 3-D Secure эмулируются разными тестовыми номерами. Список доступен в кабинете тестовой среды.