Skip to content

sumsub/agent-skills / skills/sumsub-integrate-dint-standalone

sumsub-integrate-dint-standalone

Verified

Add 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`.

FileKindSize
README.mdmarkdown4.8 KB
SKILL.mdskill md16.6 KB
examples/behavior-token.shscript2.1 KB
examples/fisherman-react.tsxother2.6 KB
examples/fisherman-vanilla.htmlother2.4 KB
examples/submit-platform-event.shscript3.7 KB
references/standalone-flow.mdmarkdown3.9 KB
scripts/preflight.shexecutablescript7.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.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall