Skip to main content
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 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

FieldTypeDescription
cardholderIdstringThe newly created cardholder ID
firstNamestringCardholder first name
lastNamestringCardholder last name
emailstringCardholder email address
statusstringAlways ACTIVE at creation
kycStatusstringPENDING if KYC is required; WAIVED if the program skips KYC for this cardholder type
externalIdstring or nullYour internal user ID, if provided
For the full event group documentation see Cardholder Events. 
{
  "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

​
Authorization
string
header
required

API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.

Body

application/json
​
event
string
Example:

"CARDHOLDER_CREATED"

​
eventId
string
​
businessId
string
​
environment
enum<string>
Available options:
LIVE,
SANDBOX
​
timestamp
string<date-time>
​
data
object

Response

200

Acknowledge the event.