Перейти к основному содержимому

Статусы

В Merchant API три набора статусов: статусы транзакций для выплат, переводов и других транзакций; статусы платежей для заказов, оплаченных через криптоинвойсы; и статусы инвойсов, которые подробнее описывают криптоплатёж.

Статусы транзакций​

Возвращаются методами Получение транзакции и Получение истории транзакций.

СтатусЗначениеИтоговый
CREATEDТранзакция создана.Нет
READY_TO_PROCESSТранзакция готова к обработке.Нет
PENDINGТранзакция ожидает действия или проверки.Нет
PROCESSINGТранзакция обрабатывается.Нет
EXCHANGINGИдёт конвертация валюты.Нет
COMPLETEDТранзакция завершена.Да
CANCELLINGИдёт отмена.Нет
CANCELEDТранзакция отменена.Да
REFUNDINGИдёт возврат.Нет
REFUNDEDСредства по транзакции возвращены.Да

Считайте выплату завершённой, только когда её статус — COMPLETED. Отслеживайте транзакцию, пока она не перейдёт в итоговый статус.

Итоговый статус может измениться, если позже будет сделан возврат: тогда транзакция в статусе COMPLETED переходит в REFUNDING и REFUNDED.

Статусы платежей​

Возвращаются в paymentStatus методом Получение платёжного заказа.

СтатусЗначениеЧто делать
CREATEDИнвойс создан. Volet.com ещё не завершил обработку платежа по нему.Оставьте заказ в ожидании.
PROCESSINGVolet.com обрабатывает платёж.Оставьте заказ в ожидании.
COMPLETEDПлатёж завершён, средства зачислены на ваш аккаунт. Итоговый статус.Отметьте заказ как оплаченный и выполните его.
FAILEDПлатёж не прошёл или его транзакция отменена. Итоговый статус.Не выполняйте заказ.

У paymentStatus нет значения для возвратов. Возврат виден в transaction.status и invoice.invoiceStatus.

Когда срок инвойса истекает, paymentStatus сам по себе не меняется на FAILED: клиент может отправить платёж и после истечения срока.

Статусы инвойсов​

Возвращаются в invoice.invoiceStatus методом Получение платёжного заказа. По ним можно объяснить проблемный платёж, но не решать, оплачен ли заказ.

СтатусЗначение
NEWИнвойс создан, платёж ещё не получен.
RECEIVEDПолучена транзакция в блокчейне по инвойсу. Проверки ещё могут идти, поэтому средства пока не зачислены.
EXCHANGINGVolet.com конвертирует полученную криптовалюту в валюту получателя.
COMPLETEDИнвойс обработан, средства зачислены на ваш аккаунт.
REFUND_CONFIRMATIONВозврат платежа ожидает подтверждения.
REFUND_REQUESTEDЗапрошен возврат.
REFUNDEDПлатёж возвращён клиенту.
CLOSEDИнвойс закрыт.

invoice.penalties показывает, чем полученный платёж отличается от инвойса. Если платёж совпадает с инвойсом, список пуст:

  • UNDERPAYMENT — клиент отправил меньше senderAmount.
  • OVERPAYMENT — клиент отправил больше senderAmount. Небольшая переплата в пределах допуска не отмечается.
  • EXPIRED — платёж пришёл после истечения срока инвойса. Такой платёж не зачисляется автоматически.

invoice.externalStatus объединяет invoiceStatus и penalties в одно значение, например UNDERPAYMENT_RECEIVED или EXPIRED_PAYMENT_REFUNDED. PAYMENT_RECEIVED не означает, что средства зачислены. Используйте externalStatus только для отображения.