Песочница Payme дважды шлёт запросы, проверяя идемпотентность
Песочница Payme Merchant API отправляет запросы CreateTransaction, PerformTransaction и CancelTransaction дважды. Второй ответ должен совпадать с первым, но perform_time: Date.now() на повторе возвращает другое время, что ломает логику. Это проверяет готовность интеграции к повторным запросам в бою.
Песочница платёжного сервиса Payme (тестовая среда для разработчиков) при обработке запросов CreateTransaction, PerformTransaction и CancelTransaction отправляет их дважды. Второй ответ должен полностью совпадать с первым, но из-за использования perform_time: Date.now() на повторе возвращается другое время, что ломает логику интеграции. Это проверяет готовность системы к повторным запросам, которые возникают в реальной работе, если ответ потерялся по пути.
Автор материала описывает, как построить обработчик Merchant API, чтобы повтор любого запроса был безопасен. Ключевой элемент — использовать идентификатор транзакции Payme (params.id) как ключ идемпотентности (гарантии, что повторный запрос не создаст дубликат), защищённый уникальным индексом в базе данных, а не проверкой в коде. Также важно менять состояние транзакции и статус заказа в одной транзакции базы, а все сетевые операции (например, отправку SMS или чека) выносить в outbox (отдельный обработчик после коммита), чтобы избежать ситуации «деньги списались, а заказ неоплачен».
Для бизнеса и разработчиков, работающих с платёжными API, этот материал напоминает: тестирование в песочнице — не формальность, а точная имитация боевых условий. Игнорирование двойных запросов или неправильная обработка идемпотентности ведёт к потерянным платежам и тикетам от клиентов. Внедрение описанных практик — уникального индекса, атомарного изменения статусов и outbox — снижает риски и упрощает интеграцию с другими провайдерами, такими как Click.
Первоисточник
Новость подготовлена с помощью ИИ на основе открытых источников и может содержать неточности. Нашли ошибку — напишите на hello@tolk.media.