Documentation Index
Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Create a KYC verification session for a cardholder. Returns a short-lived URL that you redirect your user to for identity verification. KYC must be approved before cards can be issued to the cardholder.
Path Parameters
| Parameter | Type | Description |
|---|
cardholderId | string | The cardholder ID |
Request Body
| Field | Type | Required | Description |
|---|
redirectUrl | string | Yes | URL to redirect the user to after KYC is complete |
KYC Flow
Create Session
Call this endpoint to get a kycUrl
Redirect User
Redirect your user to the kycUrl — they complete identity verification on FYATU’s hosted KYC page
User Redirected Back
After completion, the user is sent to your redirectUrl with ?status=pending
Receive Webhook
Once verification is processed (typically within minutes), a cardholder.kyc.approved or cardholder.kyc.rejected webhook is sent to your webhook URL
KYC Status Values
| Status | Description |
|---|
UNSUBMITTED | KYC session not yet started |
PENDING | User completed submission — awaiting review |
APPROVED | Identity verified — cardholder can be issued cards |
REJECTED | Verification failed — cardholder cannot be issued cards |
Response Fields
| Field | Type | Description |
|---|
sessionId | string | Unique session identifier |
kycUrl | string | Short-lived URL to redirect the user to (expires in 30 minutes) |
expiresAt | string | Session expiry timestamp |
Error Codes
| Code | Description |
|---|
RESOURCE_NOT_FOUND | Cardholder not found |
KYC_ALREADY_APPROVED | Cardholder KYC is already approved |
KYC_SESSION_PENDING | A KYC session is already in progress |
The kycUrl is single-use and expires in 30 minutes. If your user doesn’t complete KYC in time, create a new session.
