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"
  }
}

{}

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

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

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

Show child attributes

Response

200

Acknowledge the event.

Guides

JIT Authorization

Card Events

Transaction Events

Cardholder Events

Account Events

Billing Events

Event Type

Payload

Payload Fields

Authorizations

Body

Response

​Event Type

​Payload

​Payload Fields

Authorizations

Body

Response

Event Type

Payload

Payload Fields