Skip to main content
PATCH
Update a cardholder

Overview

Update one or more fields on a cardholder profile. Only the fields you include in the request body are changed — absent fields are left unchanged (true PATCH semantics).

KYC-Locked Fields

After kycStatus becomes APPROVED, the following fields are immutable: The fields phone, externalId, and metadata can be updated at any time regardless of KYC status.

Updatable Fields

Example

Success Response (200)

Returns the full updated cardholder object:

Error Codes

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Body

application/json
firstName
string
lastName
string
email
string<email>
phone
string
dateOfBirth
string<date>
nationality
string
address
object
kycDocument
object

Identity document details for KYC verification. Optional on create; patchable via PATCH. Not locked after KYC approval.

externalId
string
metadata
object

Response

Cardholder updated

success
boolean
Example:

true

status
integer
Example:

200

message
string
Example:

"Cardholder retrieved"

data
object
meta
object