Введение/Справочник

Справочные значения

Коды сетей, соответствие валют и сетей, а также значения статусов платежей, используемые в API 2328.io.

На этой странице перечислены все справочные значения, используемые в запросах и ответах API.

Коды сетей

Эти коды применяются везде, где есть поле network:

Каждая валюта доступна только в части сетей. Пользуйтесь этой таблицей, чтобы выбрать допустимую комбинацию:

Валюта	Допустимые сети
`USDT`	TRX-TRC20, BSC-BEP20, ETH-ERC20, AVAX-C, POL-MATIC, TON, SOL
`USDC`	BSC-BEP20, ETH-ERC20, AVAX-C, POL-MATIC, SOL
`BTC`	BTC
`ETH`	ETH-ERC20
`BNB`	BSC-BEP20
`TRX`	TRX-TRC20
`LTC`	LTC
`DASH`	DASH
`TON`	TON
`AVAX`	AVAX-C
`POL`	POL-MATIC
`SOL`	SOL
`DOGE`	DOGE

Поле payment_status у платежей и фильтр в /v1/payment/list принимает следующие значения:

Статус	Описание
`pending`	Создан, ожидает инициализации
`check`	Ожидает оплаты от клиента
`paid`	Успешно оплачен
`underpaid_check`	Недоплата (можно доплатить)
`underpaid`	Недоплата
`overpaid`	Переплата (зачислено)
`cancel`	Отменён / истёк срок
`aml_lock`	Транзакция заблокирована по AML

При обработке успешных платежей считайте успешными состояниями и paid, и overpaid — в обоих случаях зачисляйте заказ клиенту.

Поле status у /v1/payout и /v1/payout/status/{uuid} принимает одно из значений:

Статус	Описание
`pending`	Создана, ожидает обработки
`completed`	Успешно завершена — заполнен `txid`
`failed`	Ошибка отправки — см. `error_type`
`cancelled`	Отменена

Когда у выплаты status = failed, поле error_type указывает на причину:

Код	Описание
`aml_risk`	Выплата заблокирована AML-проверкой (адрес получателя помечен как высокорисковый)