Skip to main content
DELETE
Remove a cardholder

Authorizations

Api-Key
string
header
required

Partner API key. Must carry the cards permission.

Headers

Api-Version
string
default:2026-09.1
required

The API version this request targets. 2026-09.1. See Versioning.

Pattern: ^\d{4}-\d{2}\.\d+$

Path Parameters

businessId
string
required

The enrolled business (cus_).

Example:

"cus_1Xb7cV4bN7mQ0wE3rT5y"

cardholderId
string
required

The cardholder to remove (cus_).

Example:

"cus_8Qw2mZ4pL7nR1tY6vB3x"

Response

The cardholder, now canceled.

Fields without a value are left out.

cardholderId
string

The cardholder (cus_).

Example:

"cus_8Qw2mZ4pL7nR1tY6vB3x"

businessId
string

Their business (cus_).

Example:

"cus_1Xb7cV4bN7mQ0wE3rT5y"

firstName
string
lastName
string
email
string
status
enum<string>

pending — under review. active — approved; cards can be issued. rejected — not approved. canceled — removed; their cards are canceled. locked is reserved and not returned today.

Available options:
pending,
active,
rejected,
locked,
canceled