Skip to main content
Requirements
  • API key pair
  • Custom flow created via dashboard
  • Session creation via API enabled (done by iDenfy staff)
  • Finances
KYB Integration Schema

​
Step 1: Create Business Verification Form Session

For full request and response details, see the API Reference tab for the kybTokensCreate endpoint.
  • If you omit flow, iDenfy uses your account’s default KYB flow.
  • iDenfy refuses token creation if your account lacks finances for the flow.
The response contains the tokenString for the client’s link and the companyId used in every form endpoint. It also includes the session settings: expiration, isValid, clientId, externalRef, locale, flow, theme, tags and scanRefs.
Pass one or more existing identity verification scanRefs in the scanRefs field to link already-verified individuals (Directors, Representatives, Beneficial Owners) to this company without requiring them to re-verify. The same scanRef can be reused across any number of companies — see KYC Integration.

​
Step 2: Create Company

After you generate the token, you can:
To redirect the user to the iDenfy Business verification UI, construct the redirect URL as follows:
  1. Start with the base URL
  2. Obtain the tokenString value from the new Business verification token response
  3. Append this tokenString value directly to the end of the base URL: https://kyb.ui.idenfy.com/?authToken=
Example:If the tokenString received from the API is 9TIMoX4oSVmWDJ8qS7zeFUMTh5hi1EcqqLTrPR9r, the complete redirect URL will be:
If a custom KYB URL is configured for your account, use that instead — the tokenString goes where your URL has the {{token_string}} placeholder.
The token response contains no ready-made link. Build it from the tokenString as shown above. A /welcome path is not needed.