Skip to main content
POST
Terminate a card

Overview

POST /cards/{id}/terminate permanently disables a card. The action is irreversible — a terminated card cannot be reactivated. Any remaining balance on the card is automatically refunded to your company’s USD wallet as part of the same call.

When to use it

  • A customer reports their card details are compromised.
  • An employee leaves and their per-diem card needs to be killed.
  • Cleaning up unused cards to free up your card-slot allowance.
For a temporary disable that preserves the card and balance, use PUT /cards/{id}/freeze instead.

Prerequisites

  • The card must belong to your company.
  • Card status must not already be TERMINATED.

Request

Headers

Path parameters

Query parameters

Body

None.

Response

201 — Termination successful

Error responses

Important notes

  • Termination is irreversible. Once a card is TERMINATED, you cannot unfreeze, fund, or otherwise reactivate it.
  • The remaining balance is automatically refunded to the company USD wallet — you do not need to call POST /cards/{id}/withdraw first.
  • Webhook delivery failures do not roll back the termination. The card is terminated even if your webhook receiver is down.

Webhooks fired

Code examples

cURL
Node.js (axios)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

Card ID to terminate

Response

Card terminated successfully. Balance refunded to company USD wallet.

success
boolean
Example:

true

statusCode
integer
Example:

201

message
string
Example:

"Card terminated successfully"

data
object