Как Ketmus защищает баланс мерчанта: ключи, недоплаты и время жизни счёта

Ключ API даёт право создавать счета и читать данные проекта, поэтому его компрометация — главный риск для мерчанта. Ниже — встроенные механизмы Ketmus, которые ограничивают ущерб и помогают настроить приём платежей под ваш сценарий.

Ротация ключа и 24-часовая блокировка выплат

Если вы подозреваете утечку, перевыпустите ключ в разделе «Мерчант». Старый ключ перестаёт работать сразу, а выплаты по проекту блокируются на 24 часа. Так злоумышленник, даже получив доступ к кабинету вместе с ключом, не сможет сразу вывести средства, а у вас есть время разобраться.

Допуск недоплаты

Из-за комиссий бирж и кошельков плательщик часто отправляет чуть меньше, чем указано. Параметр underpaid_coverage_bps задаёт порог, при котором счёт всё равно считается оплаченным: значение в базисных пунктах, 100 bps = 1%. Его можно установить в настройках проекта или передать для отдельного счёта. Если недоплата больше порога, счёт переходит в wrong_amount_waiting и ждёт доплаты до истечения срока.

Время жизни счёта

По умолчанию счёт действует 1 час. В настройках проекта срок меняется от 5 минут до 24 часов, а через API полем lifetime_sec — от 60 секунд до 30 дней. Короткий срок защищает от оплаты по устаревшему курсу, длинный удобен для счетов, которые отправляют по почте или в мессенджер. Перевод, пришедший после истечения срока, не теряется: вы получите событие invoice.late_payment.

Кто платит комиссию

Комиссия Ketmus за приём — 1% с оплаченного счёта. Поле fee_payer определяет, удерживается ли она из суммы, которую получаете вы (merchant), или добавляется к сумме для плательщика (payer). Значение по умолчанию задаётся в настройках проекта, а для отдельного счёта его можно переопределить в запросе.