# sumsub-integrate-websdk

Проводит через всю интеграцию Sumsub KYC в веб-проект: от уровня проверки до вебхука, который открывает пользователю доступ.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1200 установок · ★ 7
- Автор: sumsub
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/sumsub/agent-skills/tree/HEAD/skills/sumsub-integrate-websdk/SKILL.md
- Обновлён: 2026-10-02
- HTML: https://affpapa.org/nevibecode/skills/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-токен создаёт реальные сессии, поэтому в интеграции его не используют.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-integrate-websdk -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/sumsub-integrate-websdk/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/sumsub-integrate-websdk/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-integrate-websdk -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/sumsub-integrate-websdk/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-integrate-websdk -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/sumsub-integrate-websdk/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sumsub/agent-skills sumsub-integrate-websdk
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/sumsub-integrate-websdk/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-integrate-websdk -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-integrate-websdk
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/sumsub-integrate-websdk/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add sumsub/agent-skills --skill sumsub-integrate-websdk -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/sumsub/agent-skills/tree/HEAD/skills/sumsub-integrate-websdk/SKILL.md

## Когда брать
- встроить виджет Sumsub KYC на страницу и запустить проверку
- подписать серверный запрос и выдать access token браузеру
- обновлять токен, пока пользователь проходит проверку
- отличить UX-события браузера от достоверного вердикта
- проверить интеграцию в sandbox до выхода в продакшен

## Примеры запросов агенту
- Добавь Sumsub WebSDK на страницу верификации, уровень `basic-kyc-level`
- Сделай эндпоинт `POST /api/sumsub/access-token`, который возвращает токен для текущего пользователя
- Настрой обработку вебхука `applicantReviewed` и выдавай доступ по вердикту

## Похожие
- [mcp-unico](https://affpapa.org/nevibecode/mcp/mcp-unico.md) — MCP-сервер · ★ 274
- [mcp-onfido](https://affpapa.org/nevibecode/mcp/mcp-onfido.md) — MCP-сервер · ★ 274
- [integrate-whatsapp](https://affpapa.org/nevibecode/skills/integrate-whatsapp.md) — скилл · 4700 установок
- [clerk](https://affpapa.org/nevibecode/skills/clerk.md) — скилл · 30000 установок
- [chainlink-ace-skill](https://affpapa.org/nevibecode/skills/chainlink-ace-skill.md) — скилл · 310 установок
- [shopify-apps](https://affpapa.org/nevibecode/skills/sickn33-shopify-apps.md) — скилл · 1000 установок

Из того же набора: [sumsub/agent-skills](https://affpapa.org/nevibecode/by/sumsub/agent-skills.md) — 20 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md