Skip to main content
DELETE
Delete Cardholder

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

Example Usage

Example Response

Error Response - Active Cards

If the cardholder has active cards, you’ll receive a 409 Conflict error:

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