Skip to main content
Delete an enrolled card. Deletion also retires the card’s network token (the tokenized stand-in for the card at the card network) where one exists. POST /v1/deleteCard · Authenticated with your secret key.

Body

string
required
The customer whose card to delete (the user_id used at session creation).
string
required
The card to delete — the same identifier as the enrollmentId from the SDK’s collectPAN and the card_id in List Cards.
string
default:"OTHER"
Why the card is being deleted: CUSTOMER_CONFIRMED, LOST, STOLEN, SUSPECTED_FRAUD, CLOSED_ACCOUNT, or OTHER.

Response

boolean
Whether the card was deleted.
string
The deleted card id.
boolean
Whether the deleted card was the customer’s default. If true, the customer picks a new default on their next payment.
boolean
Whether a card-network token was retired as part of the deletion.

Error responses