{
"event": "CARDHOLDER_KYC_APPROVED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:05Z",
"data": {
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"kycStatus": "APPROVED",
"kycVerifiedAt": "2026-05-22T10:00:05Z"
}
}
{}
Cardholder Events
Cardholder KYC Approved
Fired when a cardholder’s KYC verification is approved. Cards can now be issued to this cardholder.
WEBHOOK
CARDHOLDER_KYC_APPROVED
{
"event": "CARDHOLDER_KYC_APPROVED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:05Z",
"data": {
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"kycStatus": "APPROVED",
"kycVerifiedAt": "2026-05-22T10:00:05Z"
}
}
{}
Fires when a cardholder’s identity verification is approved. This is the signal to unlock card issuance in your platform. Cards cannot be issued until
For the full event group documentation see Cardholder Events.
kycStatus is APPROVED.
This is one of the most important events to subscribe to — use it instead of polling GET /cardholders/{id}.
Payload
{
"event": "CARDHOLDER_KYC_APPROVED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:05Z",
"data": {
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"kycStatus": "APPROVED",
"kycVerifiedAt": "2026-05-22T10:00:05Z"
}
}
Payload Fields
| Field | Type | Description |
|---|---|---|
cardholderId | string | The cardholder whose KYC was approved |
kycStatus | string | Always APPROVED |
kycVerifiedAt | string | ISO 8601 timestamp of approval |
What To Do When You Receive This Event
- Mark the cardholder as verified in your system
- Unlock card issuance for this cardholder in your UI
- Optionally notify the cardholder that they can now receive a card
Example Handler
Node.js
app.post('/webhooks/fyatu', async (req, res) => {
const payload = JSON.parse(req.body);
const eventType = payload.event;
if (eventType === 'CARDHOLDER_KYC_APPROVED') {
const { cardholderId } = payload.data;
// Unlock card issuance in your system
await db.cardholders.update(cardholderId, { kycApproved: true });
// Notify the cardholder
await sendEmail(cardholderId, 'Your identity has been verified — you can now get a card!');
}
res.json({ received: true });
});
{
"event": "CARDHOLDER_KYC_APPROVED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T10:00:05Z",
"data": {
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"kycStatus": "APPROVED",
"kycVerifiedAt": "2026-05-22T10:00:05Z"
}
}
{}

