Skip to main content
PUT
Terminate card

Overview

Close a card permanently. Use this when a customer no longer needs a card, or when you want to close it and return its balance. Unlike freezing, termination cannot be undone.

What happens to the balance

You do not need to withdraw first. A card cannot be withdrawn below USD 1.00, but termination returns everything left on the card.
  • The card issuer returns the balance and it is credited back automatically, the same way a withdrawal is credited. This usually takes less than a minute.
  • balance_refund in the response tells you where it stands:
    • none: there was nothing on the card.
    • pending: the balance is on its way back. You receive the card.termination_refund webhook when it lands.
    • refunded: it was credited during this request.
  • You also receive card.terminated when the card is closed.

When a card cannot be terminated

Terminating a card that is already terminated returns 200 with already_terminated: true, so the call is safe to retry.

Authorizations

X-API-KEY
string
header
required

API key for authentication.

Path Parameters

card_id
integer
required

unique id of the customers card

Response

200 - Success

status
boolean
data
object
error
any[]
message
string