Skip to main content
DELETE
/
cardholders
/
{id}
Delete Cardholder
curl --request DELETE \
  --url https://api.fyatu.com/api/v3/cardholders/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "Cardholder deleted successfully",
  "data": {
    "id": "ch_1a2b3c4d5e6f7890abcdef1234567890",
    "deleted": true,
    "cardsDeleted": 2,
    "kycDocumentsDeleted": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Delete a cardholder from your application. Note that cardholders with active (non-terminated) cards cannot be deleted. You must terminate all associated cards first.

​
Path Parameters

ParameterTypeDescription
idstringUnique cardholder identifier

​
Example Usage

<?php
$cardholderId = 'CH1a2b3c4d5e6f';

$response = file_get_contents(
    "https://api.fyatu.com/api/v3/cardholders/{$cardholderId}",
    false,
    stream_context_create([
        'http' => [
            'method' => 'DELETE',
            'header' => 'Authorization: Bearer ' . $accessToken
        ]
    ])
);

$result = json_decode($response, true);

if ($result['success']) {
    echo "Cardholder deleted successfully\n";
}

​
Example Response

{
  "success": true,
  "status": 200,
  "message": "Cardholder deleted successfully",
  "data": {
    "id": "CH1a2b3c4d5e6f",
    "deleted": true
  },
  "meta": {
    "requestId": "req_delete123abc",
    "timestamp": "2026-01-08T16:00:00+00:00"
  }
}

​
Error Response - Active Cards

If the cardholder has active cards, you’ll receive a 409 Conflict error: 
{
  "success": false,
  "status": 409,
  "message": "Cannot delete cardholder with active cards. Please terminate all cards first.",
  "error": {
    "code": "CARDHOLDER_HAS_ACTIVE_CARDS"
  },
  "meta": {
    "requestId": "req_delete123abc",
    "timestamp": "2026-01-08T16:00:00+00:00"
  }
}

​
Deletion Requirements

Before deleting a cardholder, ensure:
  1. All cards are terminated - The cardholder must have no active cards
  2. Outstanding transactions are settled - Ensure all pending transactions are completed
This action is irreversible. Once a cardholder is deleted, all associated data is permanently removed.
Instead of deleting a cardholder, consider setting their status to INACTIVE or SUSPENDED if you may need to reference them later.

Authorizations

​
Authorization
string
header
required

JWT access token obtained from /auth/token

Path Parameters

​
id
string
required

Unique cardholder identifier

Response

Cardholder deleted successfully

​
success
boolean
Example:

true

​
status
integer
Example:

200

​
message
string
Example:

"Cardholder deleted successfully"

​
data
object