Avatarix API

Протокол обмена

Единый стандарт взаимодействия между Агентом и Платежной организацией.

Требования к интерфейсу

Transport Security

Обмен данными ведется строго по протоколу HTTPS. POST запросы.

JSON / UTF-8

Ответы в JSON. Кодировка UTF-8 обязательна.

High Load

Таймаут 60 сек. Поддержка многопоточности.

Ключевые параметры

TransactionID
Unique

Уникальный ID платежа (до 15 знаков).
Идемпотентность: повторный запрос вернет старый результат.

Amount
Format 0.00

Сумма (0.00).
Пример: 180.00

RequestDate
GMT+6

Дата запроса (yyyy-mm-dd hh:mm).

Account
Regex

Абонент (логин/счет). Regex валидация.

Обработка ошибок

Фатальные ошибки

Повтор запроса бессмысленен.
Действие: Вернуть ошибку клиенту.

Нефатальные ошибки

Временные сбои.
Действие: Повторять запрос.

Важно: Статус запроса ≠ Статус платежа

Не отменяйте платеж при ошибке сети.

Порядок работы

1

Тестовая среда (Sandbox)

Отладка без финансовых рисков.
URL: processingdev.avatarix.net

2

Боевой режим (Production)

Полная финансовая ответственность.