Search K
Ордера

Статусы ордеров

ИнформацияСтатус ордера отражает текущее состояние обмена. Поле statusNote предоставляет дополнительный контекст и включается только тогда, когда необходимо уточнить причину задержки, ошибки, возврата или действия, требуемого от пользователя.

Информация о status ​

Используйте поле status как основной источник информации о состоянии ордера. Именно это значение определяет текущий этап обработки.

Определение параметров ​

Значение
Описание
AWAITING_DEPOSIT
Ордер создан и ожидает депозит
CONFIRMING_DEPOSIT
Депозит получен и ожидает подтверждения
EXCHANGING
Выполняется обмен активов
SENDING
Средства отправляются на адрес получения
HOLD
Обработка ордера временно приостановлена
COMPLETE
Ордер успешно завершён
REFUND
Ордер возвращён
FAILED
Обработка ордера завершилась с ошибкой
ACTION_REQUEST
Для продолжения требуется дополнительное действие

Информация о statusNote ​

Поле statusNote дополняет status и помогает точнее определить причину текущего состояния ордера. Оно не заменяет статус и не должно использоваться отдельно от него.Используйте statusNote, когда одного значения status недостаточно для понимания ситуации.

Определение параметров ​

Значение
Описание
PROCESSING_DELAYED
Обработка ордера занимает больше времени, чем обычно
PROCESSING_DELAYED_NETWORK
Обработка задержана из-за состояния сети
RECEIVE_ADDRESS_HIGH_RISK
Адрес получения помечен как высокорисковый
REFUND_ADDRESS_HIGH_RISK
Адрес возврата помечен как высокорисковый
RECEIVE_ADDRESS_REJECTED
Адрес получения отклонен
REFUND_ADDRESS_REJECTED
Адрес возврата отклонен
RECEIVE_ADDRESS_INVALID
Указан неверный адрес получения
REFUND_ADDRESS_INVALID
Указан неверный адрес возврата
RECEIVE_TAG_REQUIRED
Для адреса получения требуется tag или memo
REFUND_TAG_REQUIRED
Для адреса возврата требуется tag или memo
DEPOSIT_NETWORK_MAINTENANCE
Сеть депозита временно недоступна
RECEIVE_NETWORK_MAINTENANCE
Сеть получения временно недоступна
REFUND_NETWORK_MAINTENANCE
Сеть возврата временно недоступна
WITHDRAWAL_FAILED
Не удалось отправить средства на адрес получения
ORDER_EXPIRED
Срок действия ордера истёк

Как обрабатывать status и statusNote ​

Всегда обрабатывайте status как основное поле состояния. Если statusNote присутствует в ответе, используйте его как дополнительный контекст для интерфейса, логики интеграции или отображения причины ошибки.

Примеры enum ​

Значения enum должны точно соответствовать значениям, возвращаемым API. Это предотвращает ошибки при сравнении статусов в коде.
status
export const OrderStatus = {
  AWAITING_DEPOSIT: "AWAITING_DEPOSIT",
  CONFIRMING_DEPOSIT: "CONFIRMING_DEPOSIT",
  EXCHANGING: "EXCHANGING",
  SENDING: "SENDING",
  HOLD: "HOLD",
  COMPLETE: "COMPLETE",
  REFUND: "REFUND",
  FAILED: "FAILED",
  ACTION_REQUEST: "ACTION_REQUEST",
};
statusNote
export const OrderStatusNoteEnum = {
  PROCESSING_DELAYED: "PROCESSING_DELAYED",
  PROCESSING_DELAYED_NETWORK: "PROCESSING_DELAYED_NETWORK",
  RECEIVE_ADDRESS_HIGH_RISK: "RECEIVE_ADDRESS_HIGH_RISK",
  REFUND_ADDRESS_HIGH_RISK: "REFUND_ADDRESS_HIGH_RISK",
  REFUND_ADDRESS_REJECTED: "REFUND_ADDRESS_REJECTED",
  RECEIVE_ADDRESS_REJECTED: "RECEIVE_ADDRESS_REJECTED",
  RECEIVE_ADDRESS_INVALID: "RECEIVE_ADDRESS_INVALID",
  REFUND_ADDRESS_INVALID: "REFUND_ADDRESS_INVALID",
  RECEIVE_TAG_REQUIRED: "RECEIVE_TAG_REQUIRED",
  REFUND_TAG_REQUIRED: "REFUND_TAG_REQUIRED",
  DEPOSIT_NETWORK_MAINTENANCE: "DEPOSIT_NETWORK_MAINTENANCE",
  RECEIVE_NETWORK_MAINTENANCE: "RECEIVE_NETWORK_MAINTENANCE",
  REFUND_NETWORK_MAINTENANCE: "REFUND_NETWORK_MAINTENANCE",
  WITHDRAWAL_FAILED: "WITHDRAWAL_FAILED",
  ORDER_EXPIRED: "ORDER_EXPIRED",
};
Обновлено