События API магазина и признание выручки

Граница событий

Корзина и checkout описывают воронку. Создание заказа отражает коммерческое намерение. Ревизии оплаты, исполнения, отмены и возврата определяют факт и дату признания по настроенной политике. Маржинальный доход = признанная выручка после возвратов минус квалифицированные переменные расходы канала; одного принятого события для формулы недостаточно.

Требования целостности

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

Недоступность и пример

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

Пример: тестовый пакет заказа и оплаты может пройти подпись и схему со статусом sandbox_validated и создать ноль финансовых строк. Одобренный рабочий источник всё равно сверяется по числу заказов, статусам, суммам, возвратам и расходам с независимым отчётом.