Глоссарий и соглашения по полям
Суммы и валюта
| Термин | Определение |
|---|
| amount | Целое число в минорных единицах |
| amount_with_fee | Сумма с включенной комиссией (минорные единицы) |
| currency | Код валюты / токена (USDT) |
Идентификаторы
| Термин | Определение |
|---|
| id | Внутренний UUID транзакции |
| txid | Идемпотентный внешний идентификатор клиента |
Маршрутизация и среда
| Термин | Определение |
|---|
| route | Алиас маршрута обработки, настроенный для API-ключа |
| env | Среда: prod (по умолчанию) или test |
Статусы
| Статус | Значение |
|---|
| created | Принята, ожидает обработки |
| charging | В процессе проведения |
| charged | Успешно завершена |
| rejected | Ошибка / отказ |
Временные поля
| Поле | Значение |
|---|
| started | Время начала обработки (ISO) |
| finished | Время достижения терминального статуса |
Объекты money_storage
| Поле | Значение |
|---|
| network | Blockchain-сеть (ETH, TRX и т.п.) |
| type | Тип инструмента (bank_card, p2p_proxy) |
| wallet_id | Идентификатор кошелька |
| cardnumber | PAN виртуальной карты |
| cvv | CVV виртуальной карты |
| exp_month / exp_year | Срок действия (строки) |
| cardholder | Имя держателя |
Ошибки
| Поле | Значение |
|---|
| error_description | Текстовое описание ошибки (нестабильно) |
Идемпотентность
Повторяйте запрос создания только с тем же txid.
Поллинг
Интервалы: 1s → 2s → 4s → 8s (лимит, например 30s) до charged / rejected.
Webhook
Информирует об изменении — статус подтверждайте через GET.