Developer overview

Verifi360 provides APIs and SDKs to embed KYC verification, document intelligence, and sanctions screening into your applications.

Quick start

Integrate in six steps from account creation to production.

1. 1

   Create account

   Sign up in the Verifi360 dashboard.

2. 2

   Get API keys

   Dashboard → API Keys (publishable + secret).

3. 3

   Use SDK or REST

   Build with @verifyx/kyc-sdk (packages/sdk) or HTTP.

4. 4

   Start a session

   POST /kyc/start with the secret key from your server.

5. 5

   Complete flow

   Upload documents/selfie/liveness; poll GET /kyc/status/:sessionId.

6. 6

   Webhooks

   Set webhookUrl and webhookSecret in tenant settings (dashboard).

1import { init, startSession } from '@verifyx/kyc-sdk';
2
3init({
4  baseUrl: 'https://www.verifi360.com/api',
5  secretKey: process.env.VERIFI360_SECRET_KEY!,
6});
7
8const session = await startSession({
9  docTypes: ['passport'],
10  requireSelfie: true,
11});
12
13console.log(session.sessionId, session.clientToken);

SDK

In-repo TypeScript SDK and direct REST.

1npm run build:sdk (monorepo) — package name @verifyx/kyc-sdk

1curl, fetch, or any HTTP client

API authentication

Secure every request with the right credential type.

1curl -X POST https://www.verifi360.com/api/kyc/start \
2  -H "Content-Type: application/json" \
3  -H "x-api-key: YOUR_SECRET_KEY" \
4  -H "x-timestamp: $(date +%s)000" \
5  -H "x-signature: YOUR_HMAC_HEX" \
6  -d '{"docTypes":["passport"],"requireSelfie":true}'

API reference

Base URL: https://www.verifi360.com/api

1{
2  "docTypes": ["passport"],
3  "requireSelfie": true,
4  "requireLiveness": false
5}

1{
2  "sessionId": "...",
3  "clientToken": "...",
4  "stepsRequired": { "doc": true, "selfie": true, "liveness": false },
5  "expiresAt": "..."
6}

1{
2  "sessionId": "...",
3  "status": "completed",
4  "steps": { "doc": {}, "selfie": {}, "liveness": {} },
5  "decision": {},
6  "expiresAt": "..."
7}

1{
2  "name": "John Smith",
3  "yearOfBirth": "1986",
4  "country": "GB",
5  "clientReference": "cust_12345",
6  "idempotencyKey": "urim-single-cust-12345-v1"
7}

1{
2  "search": {
3    "_id": "...",
4    "status": "completed",
5    "creditsCharged": 1.99,
6    "creditTransactionReference": "urim-search:..."
7  },
8  "requestId": "...",
9  "creditPrecheck": true
10}

1{
2  "batchId": "batch_...",
3  "summary": {
4    "total": 10,
5    "success": 8,
6    "failed": 2,
7    "chargedCount": 8,
8    "totalCharged": 15.92
9  },
10  "results": []
11}

Webhooks

Receive real-time verification lifecycle events at your HTTPS endpoint.

1import crypto from 'crypto';
2
3function verifyWebhook(rawBody: string, timestamp: string, signature: string, secret: string) {
4  const expected = crypto.createHmac('sha256', secret).update(timestamp + '\n' + rawBody).digest('hex');
5  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
6}
7// Headers from Verifi360: X-Webhook-Timestamp, X-Webhook-Signature

1{
2  "sessionId": "...",
3  "status": "collecting"
4}

Rate limits & usage

Error codes

On 429, backoff until resetAt. On 5xx, retry with backoff.

Security

FAQ

Support & resources