Skip to main content
POST
Suspend a cardholder

Overview

Suspends an active cardholder. While suspended, all cards issued to the cardholder are immediately blocked — transactions will be declined at the network level. Suspension is reversible via POST /cardholders/{id}/reactivate.

Path Parameters

Request Body (optional)

An empty body {} is also valid — reason is optional.

Example

Success Response (200)

Returns the full updated cardholder object with status: SUSPENDED:

Webhook

A CARDHOLDER_SUSPENDED event fires immediately after a successful suspension:

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
reason
string
Example:

"Suspected fraudulent activity"

Response

Cardholder suspended

success
boolean
Example:

true

status
integer
Example:

200

message
string
Example:

"Cardholder retrieved"

data
object
meta
object