Проектирование надёжных платёжных API
Вебхуки и очереди, которые переживают дубликаты, задержки и сбои без порчи состояния.
- Внешний провайдер отправляет событие; эндпоинт проверяет его подпись, прежде чем ему доверять.
- Ключ идемпотентности гарантирует, что одно и то же событие не будет применено дважды.
- Работа отправляется в очередь и обрабатывается воркерами с повторами и backoff.
- Только после этого меняется бизнес-состояние — счёт оплачен, заказ движется дальше.
Контекст
PayX стоит между мерчантами и платёжными провайдерами: мерчант выставляет счёт, клиент платит, и backend мерчанта должен об этом узнать.
Техническая задача
Колбэки могут прийти с опозданием, дважды или не прийти вовсе, а платёж нельзя ни применить дважды, ни потерять.
Выбранное решение
Подход, на котором построен поток: проверить входящее событие, прежде чем ему доверять, применить его идемпотентно и вынести медленную работу в очередь с повторами — с записью каждой транзакции и комиссии.
Компромиссы
Асинхронная обработка означает, что мерчант может увидеть платёж чуть позже, а не мгновенно, — цена того, что счёт никогда не будет зачислен дважды.
Результат
Мерчанты подключаются через один API для разработчиков: счета, колбэки, комиссии и учёт транзакций.
Все разборы