Antifraud Module

The Antifraud module collects device, browser, and behavioral signals in the background and submits them to Incode's antifraud engine. Fire-and-forget —

📘

This guide is specific to Web SDK 2.0. If you are still using 1.x, you can find documentation here. Contact your Incode Representative for upgrade information and check if you are a candidate for this upgrade.

Full rollout to all clients still TBD.


The Antifraud module collects device, browser, and behavioral signals in the background and submits them to Incode's antifraud engine. Fire-and-forget — completes regardless of API outcome so the verification flow is never blocked.

Follows the backend-process pattern. See the patterns page for the shared lifecycle.

Tag

<incode-antifraud> is a standard Web Component. Importing the UI subpath registers the custom element.

import '@incodetech/web/antifraud';
import '@incodetech/web/antifraud/styles.css';

The component is essentially invisible — it runs the check and emits onFinish. You can mount it during transitions while showing your own loading UI.

Properties

PropertyTypeRequiredDescription
configAntifraudConfigNo options — type is Record<string, never>
onFinish() => voidCalled when the check completes
onError(error: string) => voidCalled on a fatal error (rare — module swallows API errors by design)

Configuration

The module takes no configuration:

type AntifraudConfig = Record<string, never>;

State machine

AntifraudState is minimal — a discriminated union over status:

StatusDescription
idleInitial state.
processingCollecting signals and submitting to the backend.
finishedTerminal — check is done (success or silent failure).

See also