Buvei
API ReferenceWebhook Events

CARDHOLDER_KYC_STATUS

A KYC cardholder reached a terminal verification status.

Delivered when a cardholder transitions out of PENDING to a terminal state — APPROVED or REJECTED. Fires for both AUTO (Didit) and MANUAL flows.

Payload

eventIdstring
eventTypestring
Always "CARDHOLDER_KYC_STATUS".
timestampinteger
Epoch milliseconds.
dataobject
Response
{
  "eventId": "e_kyc789xyz",
  "eventType": "CARDHOLDER_KYC_STATUS",
  "timestamp": 1640995700000,
  "data": {
    "id": "kyc_8f3a9c2b1d4e5f6a",
    "firstName": "John",
    "lastName": "Doe",
    "kycStatus": "APPROVED",
    "kycRejectReason": null
  }
}

After APPROVED, you can immediately use the cardholder's id as cardholderId in POST /cards.

On this page

Payload