TREVEX KYB Documentation

When you call create_claim and the response contains user_verified: false, TREVEX has started a verification flow behind the scenes. No further action is required from the partner.

What happens

Draft account created

TREVEX creates a draft account for the user keyed by user_email.

Verification email sent

An email with a secure link is sent to user_email.

User clicks the link

Their browser calls verify_account with a one-time token. This endpoint is public by design.

Account activated

The draft is converted into a TREVEX account and a set-password email is sent (link valid 48 hours).

KYB request unblocked

Every KYB request linked to this draft automatically moves from pending_verification to under_review.

Checking ahead of time

If you want to avoid the draft-account path entirely, call user_lookup before submitting. If the user exists and is verified, your create_claim response will come back with user_verified: true immediately.

What to show the end user

If user_verified is false, tell the user to check their inbox for a verification email before the KYB request can be reviewed. A simple message works:

We’ve sent a verification email to john.doe@example.com. Please confirm your address to continue. Your KYB request will be reviewed automatically once verified.