Kontur
О Kontur 4.0

Kontur 4.0 — подключение

В документации v2 обозначает версию API Kontur 4.0. Внешний сайт можно подключить по заявке.

Вставьте клиент v2 и задайте действие. Для fetch-форм добавьте data-mode="manual" и вызывайте kontur.execute() перед отправкой.

<script src="https://kontur.mallaev-dev.ru/kontur/v2.js?k=ВАШ_КЛЮЧ" async></script>
<form method="post" action="/submit">
  <input name="email" type="email" required>
  <div class="kontur" data-action="signup"></div>
  <button>Отправить</button>
</form>

Сервер принимает непрозрачное поле kontur-response, извлекает идентификатор операции и отправляет квитанцию на verify. Секрет остаётся только на сервере.

Для Node.js и Next.js используйте готовый серверный модуль: он добавляет общие квоты, ограничения тела и времени, проверяет привязки и отклоняет повтор до обработчика. Ниже — низкоуровневый контракт для самостоятельной интеграции.

// На сервере (Node.js):
import { decodeReceiptResponse } from '@kontur/client';
const { response, request_id } = decodeReceiptResponse(formData.get('kontur-response'));
const verification = await fetch('https://kontur.mallaev-dev.ru/api/kontur/v2/verify', {
  method: 'POST', headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ secret: process.env.KONTUR_SITE_SECRET, response, request_id,
    expected_action: 'signup', expected_hostname: 'shop.example.com', remoteip: visitorIp }),
});
const result = await verification.json();
if (result.status === 'challenge') { /* верните challenge на страницу */ }
if (!result.success) { /* прекратите обработку */ }
// Резервируйте request_id и хеш бизнес-запроса атомарно в своей БД.
// Повтор сохранённого success не должен повторно отправлять письмо или списывать деньги.

При challenge передайте объект в kontur.challenge(data.challenge) и повторите отправку после проверки. Изменение данных с прежним идентификатором операции даёт конфликт. Сетевой повтор отправляет тот же запрос; успешная повторная проверка сама по себе не дедуплицирует бизнес-действие.

Клиенту нужны HTTPS-доступ к API и worker-src blob: в CSP. Если worker запрещён, проверка показывает недоступность и не выдаёт пропуск. Клиент использует вычисление SHA-256 в фоновом потоке.