Delete Card
Server-Side API
Delete Card
Delete a customer’s enrolled card and retire its network token
POST
Delete Card
Notes
card_idis the same identifier as theenrollmentIdreturned by the SDK’scollectPANand thecard_idin List Cards.- Deletion also retires the card’s network token (the tokenized stand-in for the card at the card
network) where one exists —
network_token_deletedin the response tells you whether that happened. - If the deleted card was the customer’s default,
was_defaultistrue; the customer picks a new default on their next payment.
Error responses
Authorizations
Your secret key: sk_test_* (sandbox) or sk_live_* (production).
Body
application/json
The customer whose card to delete (the user_id used at session creation)
The card to delete (same as enrollmentId from the SDK's collectPAN())
Why the card is being deleted
Available options:
CUSTOMER_CONFIRMED, LOST, STOLEN, SUSPECTED_FRAUD, CLOSED_ACCOUNT, OTHER