{
"event": "CARDHOLDER_CREATED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"firstName": "Jane",
"lastName": "Doe",
"email": "jane.doe@example.com",
"status": "ACTIVE",
"kycStatus": "PENDING",
"externalId": "my-user-id-789"
}
}
{}
Cardholder Events
CARDHOLDER_CREATED
Fired when a new cardholder profile is created. KYC verification starts automatically.
WEBHOOK
CARDHOLDER_CREATED
{
"event": "CARDHOLDER_CREATED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"firstName": "Jane",
"lastName": "Doe",
"email": "jane.doe@example.com",
"status": "ACTIVE",
"kycStatus": "PENDING",
"externalId": "my-user-id-789"
}
}
{}
Fires immediately after a new cardholder is created via
For the full event group documentation see Cardholder Events.
POST /cardholders. KYC verification is triggered automatically — subscribe to CARDHOLDER_KYC_APPROVED or CARDHOLDER_KYC_REJECTED to be notified when verification completes.
Event Type
CARDHOLDER_CREATED
Payload
{
"event": "CARDHOLDER_CREATED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"firstName": "Jane",
"lastName": "Doe",
"email": "jane.doe@example.com",
"status": "ACTIVE",
"kycStatus": "PENDING",
"externalId": "my-user-id-789"
}
}
Payload Fields
| Field | Type | Description |
|---|---|---|
cardholderId | string | The newly created cardholder ID |
firstName | string | Cardholder first name |
lastName | string | Cardholder last name |
email | string | Cardholder email address |
status | string | Always ACTIVE at creation |
kycStatus | string | PENDING if KYC is required; WAIVED if the program skips KYC for this cardholder type |
externalId | string or null | Your internal user ID, if provided |
{
"event": "CARDHOLDER_CREATED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:00Z",
"data": {
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"firstName": "Jane",
"lastName": "Doe",
"email": "jane.doe@example.com",
"status": "ACTIVE",
"kycStatus": "PENDING",
"externalId": "my-user-id-789"
}
}
{}
Authorizations
API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.
Body
application/json
Response
200
Acknowledge the event.