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>'
import requests

url = "https://api.fyatu.com/api/v3/cardholders/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fyatu.com/api/v3/cardholders/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fyatu.com/api/v3/cardholders/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fyatu.com/api/v3/cardholders/{id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.delete("https://api.fyatu.com/api/v3/cardholders/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.fyatu.com/api/v3/cardholders/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
{
  "success": true,
  "status": 200,
  "message": "Cardholder deleted successfully",
  "data": {
    "id": "ch_1a2b3c4d5e6f7890abcdef1234567890",
    "deleted": true,
    "cardsDeleted": 2,
    "kycDocumentsDeleted": true
  }
}
{
  "success": false,
  "status": 401,
  "message": "Unable to identify business",
  "error": {
    "code": "AUTH_TOKEN_INVALID"
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-01-05T10:30:00+00:00"
  }
}
{
  "success": false,
  "status": 404,
  "message": "Wallet not found",
  "error": {
    "code": "RESOURCE_NOT_FOUND"
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-01-05T10:30:00+00:00"
  }
}
{
  "success": false,
  "status": 409,
  "message": "Cannot delete cardholder with active cards. Please terminate all cards first.",
  "error": {
    "code": "CARDHOLDER_HAS_ACTIVE_CARDS"
  }
}

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

const cardholderId = 'CH1a2b3c4d5e6f';

const response = await fetch(
  `https://api.fyatu.com/api/v3/cardholders/${cardholderId}`,
  {
    method: 'DELETE',
    headers: {
      'Authorization': `Bearer ${accessToken}`
    }
  }
);

const result = await response.json();

if (result.success) {
  console.log('Cardholder deleted successfully');
}

​
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