sumsub/agent-skills / skills/sumsub-integrate-dint-standalone
sumsub-integrate-dint-standalone
VerifiedAdd Sumsub Device Intelligence (the Fisherman JS module) to your own web pages where there is NO Sumsub verification widget — login, signup, password reset, 2FA, checkout, or any high-value action you want fraud-screened. TRIGGER when the user asks to "add device intelligence to login / signup", "fingerprint the device on a custom page", "use Fisherman standalone / self-hosted", "ongoing monitoring of platform events", "pre-KYC device check", "detect multi-accounting at signup", or "send a financial transaction with the captured device". Covers the whole loop — behavior access token, @sumsub/fisherman init + fingerprint, confirming the event (platform event / financial transaction / create-applicant), reading results, sandbox, go-live. SKIP when the page already embeds the Sumsub WebSDK — Device Intelligence rides along inside it, use `sumsub-integrate-dint-websdk`.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 4.8 KB |
| SKILL.md | skill md | 16.6 KB |
| examples/behavior-token.sh | script | 2.1 KB |
| examples/fisherman-react.tsx | other | 2.6 KB |
| examples/fisherman-vanilla.html | other | 2.4 KB |
| examples/submit-platform-event.sh | script | 3.7 KB |
| references/standalone-flow.md | markdown | 3.9 KB |
| scripts/preflight.shexecutable | script | 7.0 KB |
references/standalone-flow.md
View on GitHub# Standalone Device Intelligence — event variants and failure-mode rules
Extends [SKILL.md](../SKILL.md). Covers: when to use the standalone path,
complete JSON bodies for each confirm variant, reading results, and failure-mode rules.
The four-stage loop and device-linking mechanics are in SKILL.md.
## When standalone (vs WebSDK)
| Use standalone (this skill) | Use the WebSDK path |
|---|---|
| Login, signup, password reset, 2FA | The page shows the Sumsub KYC widget |
| Checkout / payment / withdrawal screening | Document + selfie verification flow |
| Pre-KYC gating (screen before account creation) | Identity verification itself |
| Any custom page with no Sumsub widget | — |
If a Sumsub WebSDK widget is on the page, DI is already bundled — see
[`sumsub-integrate-dint-websdk`](../../sumsub-integrate-dint-websdk/SKILL.md). Don't run
both on the same page.
## Event / confirm variants (extends SKILL.md Stage 3)
All three hit the no-applicant transaction endpoint (the applicant is resolved by
`applicant.externalUserId`), App-Token + HMAC signed with the behavior token
carried alongside as the `?accessToken=` query param (it rides with signing, it
does not replace it).
**Applicant platform event** — login / signup / password reset / 2FA:
```json
POST /resources/applicants/-/kyt/txns/-/data?accessToken=<behaviorToken>
{
"txnId": "<unique-id-you-generate>", // required — rejected with 422 if missing
"type": "userPlatformEvent",
"applicant": { "externalUserId": "<your-user-id>", "type": "individual" },
"userPlatformEventInfo": {
"type": "login"
// type ∈ login | failedLogin | signup | passwordReset | twoFaReset | general
// optional: "passwordHash": "...", "twoFaUsed": true
}
}
```
**Financial transaction** — payment / withdrawal / transfer screening:
```json
POST /resources/applicants/-/kyt/txns/-/data?accessToken=<behaviorToken>
{
"txnId": "<unique-id-you-generate>", // required
"type": "finance",
"applicant": { "externalUserId": "<your-user-id>", "type": "individual" },
"info": {
"amount": 100.0,
"currencyCode": "EUR",
"currencyType": "fiat", // fiat | crypto
"direction": "out" // out = applicant sends, in = applicant receives
}
}
```
**Create applicant (pre-KYC)** — screen a user before/at signup: create the
applicant with `levelName`, `accessToken`, `externalUserId` (optionally
`creationTrackingData.ip` for Advanced IP), then **request the applicant
check** to trigger the DI analysis.
Authoritative, exhaustive schemas (the bodies above are the load-bearing subset):
- <https://docs.sumsub.com/reference/send-applicant-platform-event-with-captured-device>
- <https://docs.sumsub.com/reference/send-financial-transaction-with-captured-device>
- <https://docs.sumsub.com/reference/use-device-intelligence-for-pre-kyc-check>
## Reading results
- **Dashboard:** Transactions and Travel Rule → Transactions → filter type
**User platform event** → open a row for device details + risk labels.
- **Webhooks:** transaction/event reviewed webhooks; verify the signature on
**raw bytes** (same rules as the WebSDK skill's webhook stage).
- **Risk labels & scoring:** the device label catalog is shared with the WebSDK
path — full signal definitions are in the `sumsub-integrate-dint-websdk`
skill's `references/device-signals.md` (install that skill for the file).
## Failure-mode rules
- **Fail open.** DI is a fraud signal, not an auth gate on your own page. A
Fisherman init/fingerprint error must never block login/signup. Wrap in
try/catch and proceed.
- **One `sessionId` per logical session**, generated server-side and opaque —
it is what correlates the captured device to the confirm call. No device
fields are needed in the confirm body. (`deviceBindingId` in `fingerprint()`
is a migration-path option only, not required for the default flow.)
- **Don't trust the browser** for the verdict — read it from the dashboard or a
webhook, server-side.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |