← ALB News · curated headline

Payme Merchant API: песочница шлёт каждый запрос дважды, и это лучший тест вашей интеграции

Habr · RU · Programming · 11/18/2026, 3:33:48 PM

В песочнице Payme есть правило, которое легко пропустить при чтении документации: запросы CreateTransaction , PerformTransaction и CancelTransaction она посылает дважды, и ответ на второй должен совпасть с ответом на первый. Интеграция, написанная «по шагам», на этом и падает. Чаще всего из-за одной строки: perform_time: Date.now() , которая на повторе возвращает уже другое время. Песочница не придирается. Она проверяет ровно то, что потом случится в бою: ответ потерялся по дороге, Payme Business отправил тот же запрос ещё раз и ждёт, что вы ответите так же, как в первый раз. Если интеграция к этому не готова, вы получите либо платёж, который висит у Payme на ручном разборе, либо самый неприятный тикет в интернет-магазине: «деньги списались, а заказ неоплачен». Дальше — как я строю обработчик Merchant API, чтобы повтор любого запроса был безопасен. Код на TypeScript и PostgreSQL, но от языка тут почти ничего не зависит. Что Payme обещает и чего требует Пять фактов из документации, на которых держится всё остальное. Протокол — JSON-RPC 2.0 поверх HTTP POST. Отвечать нужно всегда со статусом 200 , даже на ошибку: бизнес-ошибка лежит в поле error тела. Любой другой статус Payme засчитывает как системную ошибку -32400 , а не как ваш отказ. Сумма приходит целым числом в тийинах . 15 000 сумов — это 1500000 . Время — 13-значный timestamp в миллисекундах. Если ответ на CreateTransaction или PerformTransaction не дошёл, Payme повторяет запрос с теми же параметрами. Транзакция в состоянии «создана» живёт 12 часов (43 200 000 мс), потом её нужно отменять. Из четвёртого пункта следует главное: идентификатор транзакции Payme ( params.id ) — это ключ идемпотентности. Свой ключ поверх него придумывать не надо. А проверять «был ли такой запрос» через select перед insert нельзя: два одинаковых запроса, пришедших параллельно, пройдут такую проверку оба. Таблица, в которую упирается всё Транзакции провайдера я храню отдельно от заказов. У заказа бывает несколько попыток оплаты, отмены и возвраты, и при разборе инцидента нужно видеть каждую. create table provider_txn ( id serial primary key, provider text not null, -- 'payme' | 'click' external_id text not null, -- params.id от Payme order_id bigint not null references orders(id), amount_tiyin bigint not null, state smallint not null, -- 1, 2, -1, -2 reason smallint, provider_time bigint, -- params.time, нужен для GetStatement create_time bigint not null, -- пишется один раз perform_time bigint not null default 0, -- пишется один раз cancel_time bigint not null default 0, -- пишется один раз raw_last jsonb, unique (provider, external_id) ); -- У заказа не может быть второй транзакции Payme, ожидающей оплаты. create unique index one_pending_per_order on provider_txn (order_id) where provider = 'payme' and Читать далее

Continue to Habr →

You are being forwarded in 6s — stay on this page