sumsub-integrate-websdk — скилл для Claude Code: KYC через WebSDK
Проводит через всю интеграцию Sumsub KYC в веб-проект: от уровня проверки до вебхука, который открывает пользователю доступ.
npx skills add sumsub/agent-skills --skill sumsub-integrate-websdk -a claude-codeЧто делает sumsub-integrate-websdk
Скилл ведёт по шагам: сначала нужен levelName, который уже существует в рабочем пространстве. Если уровня нет, агент обсуждает с вами состав проверки и передаёт задачу соседнему скиллу sumsub-create-level — сам он анкету не собирает.
Дальше идёт серверная часть: эндпоинт, который подписывает запрос HMAC и получает короткоживущий access token для пары (userId, levelName). userId здесь — это externalUserId в Sumsub, и его лучше делать стабильным и непрозрачным: UUID или id строки в базе, не email. Ошибка в выборе userId даёт дубли applicants и застрявшие в submitted заявки, а прерванную проверку потом не возобновить.
На фронте подключается sns-websdk-builder.js с CDN, дальше инициализация snsWebSdk и запуск виджета. Важный момент: события браузера вроде onApplicantStatusChanged — только для интерфейса. Решение о доступе принимайте по вебхуку applicantReviewed и чтению applicant на сервере. Для работы нужна sandbox-пара App Token и secret: production-токен создаёт реальные сессии, поэтому в интеграции его не используют.
Какие задачи решает
- встроить виджет Sumsub KYC на страницу и запустить проверку
- подписать серверный запрос и выдать access token браузеру
- обновлять токен, пока пользователь проходит проверку
- отличить UX-события браузера от достоверного вердикта
- проверить интеграцию в sandbox до выхода в продакшен
Примеры запросов агенту
- Добавь Sumsub WebSDK на страницу верификации, уровень
basic-kyc-level - Сделай эндпоинт
POST /api/sumsub/access-token, который возвращает токен для текущего пользователя - Настрой обработку вебхука
applicantReviewedи выдавай доступ по вердикту
Как установить sumsub-integrate-websdk
1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-integrate-websdk -a claude-code2Вручную: положить файлы
~/.claude/skills/sumsub-integrate-websdk/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/sumsub-integrate-websdk/
1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-integrate-websdk -a codex2Вручную: положить файлы
.agents/skills/sumsub-integrate-websdk/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-integrate-websdk -a cursor2Вручную: положить файлы
.cursor/skills/sumsub-integrate-websdk/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install sumsub/agent-skills sumsub-integrate-websdk2Вручную: положить файлы
.github/skills/sumsub-integrate-websdk/SKILL.md1Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-integrate-websdk -a gemini-cli2Командой платформы
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-integrate-websdkВручную: положить файлы
.devin/skills/sumsub-integrate-websdk/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-integrate-websdk -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о sumsub-integrate-websdk
Как установить sumsub-integrate-websdk в Claude Code?
Выполните npx skills add sumsub/agent-skills --skill sumsub-integrate-websdk -a claude-code. Скилл появится в ~/.claude/skills/sumsub-integrate-websdk/SKILL.md.
Что делает sumsub-integrate-websdk?
Проводит интеграцию Sumsub KYC в веб-проект: настройка уровня, серверная подпись access token, инициализация snsWebSdk, события жизненного цикла, обновление токена, вебхуки и проверка в sandbox.
Можно ли использовать production App Token при интеграции?
Нет. Скилл требует sandbox-пару App Token и secret: production-токен создаёт реальные SDK-сессии, привязанные к настоящим applicants.
