Widget Integration

The VerifiMe widget is a drop-in UI component that handles the customer verification experience for you. It is the recommended integration path, but not required. If you need full control over the UI, you can build a custom integration using the inviteUrl and tracking status API directly.

Try it live: Use the Widget Demo to test the full invite + widget flow against the staging environment.

Widget Initialisation

1. Load the widget script (production):

<script src="https://widget.static.prod.verifime.com/widgets/verifime-widget.min.js"></script>

Use the staging URL during integration testing:

<script src="https://widget.static.stage.verifime.com/widgets/verifime-widget.min.js"></script>

2. Add a container element:

<div id="verifime-widget"></div>

3. Initialise the widget:

VerifimeWidget(
  '#verifime-widget',
  trackingReference,
  {
    onSuccess: () => {
      // Customer has completed data entry (Phase 1 complete)
    },
    onError: (error) => {
      // Technical error occurred
    }
  }
);

Parameters:

The widget is loaded as the global function VerifimeWidget. An ESM import is also available for bundler-based setups - use the .esm.min.js build and import the default export.

Widget Callbacks

onSuccess() - triggers when:

• ✅ Customer completed data entry (Phase 1 complete)
• ✅ Customer has returned to your application
• ❌ Does NOT mean identity is verified
• ❌ Does NOT mean risk assessment is complete
• ❌ Currently returns undefined (no parameters)

onError(error) - triggers when a technical error occurs (network failure, API error).

Widget Behaviour

The widget automatically polls GET /v1/user/signup/tracking/{trackingReference}/status every 3 - 5 seconds.