Статусы счетов

Общие положения

Статус счёта показывает, что сейчас происходит с оплатой.

Продавец должен ориентироваться именно на status, а не на сам факт создания счёта или открытия страницы оплаты.

Заказ считается оплаченным только после статуса paid.

Список статусов

В Weelay используются основные статусы:

• pending;
• paid;
• expired;
• failed.

Эти статусы возвращаются в API и используются в webhook-событиях.

pending

pending означает, что счёт создан и ждёт оплату.

Это начальный статус нового счёта.

Пока счёт в статусе pending, продавец не должен выполнять заказ.

Покупатель может открыть payment_url, увидеть сумму, сеть, адрес получателя и выполнить оплату.

Что делать продавцу при pending

При статусе pending продавец должен:

• показать покупателю страницу оплаты;
• ждать изменения статуса;
• не выдавать товар, услугу или доступ;
• не считать заказ завершённым.

Если покупатель закрыл страницу оплаты, продавец может снова показать ему тот же payment_url, пока счёт ещё действителен.

paid

paid означает, что оплата найдена и счёт отмечен как оплаченный.

Это главный успешный статус.

После paid продавец может выполнять заказ.

Что делать продавцу при paid

При статусе paid продавец должен:

• отметить заказ как оплаченный в своей системе;
• выдать товар, услугу или доступ;
• сохранить paid_at, если это нужно для учёта;
• сохранить tx_hash, если он есть в ответе;
• не обрабатывать повторное уведомление как новую оплату.

Webhook может прийти повторно, поэтому обработка paid должна быть идемпотентной.

expired

expired означает, что срок оплаты счёта истёк.

После истечения срока покупателю лучше создать новый счёт или обратиться к продавцу.

Оплата после истечения срока может потребовать ручного разбора.

Что делать продавцу при expired

При статусе expired продавец должен:

• не выполнять заказ автоматически;
• предложить покупателю создать новый платёж;
• проверить ситуацию вручную, если покупатель утверждает, что уже оплатил;
• запросить у покупателя tx_hash, если нужен разбор.

failed

failed означает, что счёт не может быть успешно завершён в обычном сценарии.

Это не является успешной оплатой.

Продавец не должен выполнять заказ по счёту со статусом failed.

Что делать продавцу при failed

При статусе failed продавец должен:

• не выполнять заказ автоматически;
• проверить заказ и платёж вручную;
• попросить покупателя предоставить tx_hash, если он утверждает, что оплатил;
• создать новый счёт, если покупателю нужно повторить оплату.

Когда выполнять заказ

Заказ можно выполнять только при статусе paid.

Нельзя выполнять заказ при статусах:

• pending;
• expired;
• failed.

Также нельзя выполнять заказ только на основании слов покупателя, скриншота или факта открытия страницы оплаты.

Повторные уведомления

Webhook или API-проверка могут повторно сообщить о счёте, который уже был обработан.

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

Если заказ уже обработан, повторное событие не должно повторно выдавать товар, услугу или доступ.

Связь с order_id

Рекомендуется передавать order_id при создании счёта.

Так продавец сможет быстро найти свой заказ при получении статуса через API или webhook.

order_id помогает связать внутренний заказ продавца и счёт Weelay.

Связь с tx_hash

tx_hash полезен для сверки оплаты.

Если покупатель утверждает, что оплатил, но счёт не стал paid, продавец может попросить tx_hash и проверить ситуацию.

tx_hash не заменяет статус paid.

Для автоматического выполнения заказа ориентируйтесь на status.

Спорные ситуации

Если возник спор, проверьте:

• id счёта;
• order_id;
• status;
• amount;
• payment_url;
• payment_expires_at;
• paid_at;
• tx_hash.

Если данных недостаточно, покупатель должен предоставить tx_hash.

Итог

pending — ждём оплату.

paid — оплата подтверждена, можно выполнять заказ.

expired — срок оплаты истёк, автоматическое выполнение заказа запрещено.

failed — счёт не завершён успешно, нужен ручной разбор или новый счёт.

Главное правило: заказ выполняется только после paid.