Операция выполнена!
Закрыть
Хабы: Платежные системы, PostgreSQL, TypeScript, Проектирование API

В песочнице 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

Читать далее
Читайте также
НОВОСТИ

ПИШИТЕ

Техническая поддержка проекта ВсеТут

info@vsetut.pro