В настоящий момент заявка на выплату может пребывать в одном из следующих статусов:

• PENDING - Заявка принята нашей системой, но еще не обработана

• FAILED - Система попыталась обработать заявку, но шлюз не смог ее принять

• PROCESSED - Заявка отработана, платеж исполнен

• CANCELLED - Платеж был отклонен, поэтому заявка отменена и деньги возвращены.

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

SENT - когда система обработала заявку и отправила ее в шлюз, но по какой-то причине не получила однозначный результат. Это не финальный статус заявки и по большому счету для конечного пользователя не сильно отличается от PENDING или FAILED, ибо ему все так же придется периодически опрашивать систему. Однако этот статус ясно дает понять, что поведение штатное.

Ввиду серьезности последствий в случае неопределенного поведения интеграций при получении неизвестного им статуса, мы будем вводить изменения не сразу, а через примерно 1 неделю, чтобы все успели доработать свои системы.