Depository of News

Click SHOP API: подпись, Prepare и Complete, и ночная сверка, которая ловит «оплачено, а заказа нет»

habrahabr.ru · world

В первой части был Payme: шесть методов JSON-RPC, четыре состояния и песочница, которая повторяет каждый запрос. У Click всё устроено иначе: два шага вместо шести, подпись MD5 вместо Basic Auth, сумма в сумах вместо тийинов и, что важнее всего, другой ответ на повтор. Если писать обе интеграции по одному шаблону, одна из них сломается. А в конце — то, что не входит ни в один протокол, но без чего я бы не запускал приём платежей: ночная сверка. Чем Click отличается от Payme Payme Merchant API Click SHOP API Формат JSON-RPC 2.0 POST, application/x-www-form-urlencoded Проверка Basic Auth, ключ кассы sign_string , MD5 с SECRET_KEY Сумма целое, в тийинах дробное, в сумах Ключ идемпотентности params.id click_trans_id Шаги Check → Create → Perform, плюс Cancel, CheckTransaction, GetStatement Prepare ( action=0 ) → Complete ( action=1 ) Повтор проведённого платежа тот же успешный ответ ошибка -4 , «Already paid» Последняя строка — та, на которой спотыкаются, когда переносят код с Payme. Об этом ниже. Подпись У двух шагов подписи разные: Prepare: md5(click_trans_id + service_id + SECRET_KEY + merchant_trans_id + amount + action + sign_time) Complete: md5(click_trans_id + service_id + SECRET_KEY + merchant_trans_id + merchant_prepare_id + amount + action + sign_time) Строки склеиваются в том виде, в каком пришли. amount нельзя переформатировать перед подписью: если Click прислал 15000.00 , подписывать нужно 15000.00 , а не 15000 . Поэтому проверять подпись нужно до того, как поля формы превратились в числа и даты. Для сравнения с заказом сумма переводится в целые тийины без участия float : function sumToTiyin(s: string): bigint { const m = /^(\d+)(?:\.(\d{1,2}))?$/.exec(s); if (!m) throw new ClickError(-2); return BigInt(m[1]) * 100n + BigInt((m[2] ?? '').padEnd(2, '0')); } Коды ошибок, которые возвращает поставщик: 0 — успех, -1 — неверная подпись, -2 — неверная сумма, -3 — действие не найдено, -4 — уже оплачено, -5 — заказ не найден, -6 — транзакция не найдена, -7 — ошибка обновления, -8 — ошибка в запросе от Click, -9 — транзакция отменена. Prepare На этом шаге Click спрашивает: можно ли принять оплату за этот заказ на эту сумму. Документация требует проверить, что заказ существует и актуален, что товар можно отпустить и что сумма совпадает. Магазину здесь же стоит зарезервировать товар. async function prepare(r: ClickPrepare): Promise { if (!verifySign(r, { withPrepareId: false })) return err(-1); if (r.action !== '0') return err(-3); return db.tx(async (tx) => { const order = await tx.findOrderForUpdate(r.merchant_trans_id); if (!order) return err(-5); if (order.status === 'paid') return err(-4); if (order.amount_tiyin !== sumToTiyin(r.amount)) return err(-2); // insert … on conflict Читать далее

Read full article →