Skip to main content
DELETE
Terminate Card

Overview

Permanently terminate a card. Any remaining balance will be automatically returned to your business wallet. This action cannot be undone.
Terminating a card closes it immediately, but returning its remaining balance can take from seconds to several hours depending on the card network. The refundedBalance in this response is the amount we expect to return, not money that has moved.Two webhooks follow, and they mean different things:
  • card.terminated — a notification. The card is closed and unusable. Update your records; do not move money.
  • card.termination_refund — your cue to act. The balance is back in your account; now settle with your customer.
This holds for every card in your account regardless of which network issued it.

Path Parameters

Request Body (Optional)

Terminating a card closes it immediately, but returning its remaining balance can take from seconds to several hours depending on the card network. The refundedBalance in this response is the amount we expect to return, not money that has moved.You will receive card.terminated twice: once with status: "PROCESSING" when the card stops working, then again with status: "COMPLETED" and the settled refundedBalance once the balance is actually back in your account. Stop card usage on the first; release funds to your own customer only on the second.

Example Usage

Error Responses

If you want to temporarily disable a card without losing the balance, use the Freeze Card endpoint instead.

Authorizations

Authorization
string
header
required

JWT access token obtained from /auth/token

Path Parameters

cardId
string
required

Body

application/json
reason
string

Reason for terminating the card (e.g., 'Card lost', 'Card stolen', 'Account closed'). Defaults to 'Terminated by the user' if not provided.

Maximum string length: 255
reference
string

Your unique reference for this operation. Defaults to cardId if not provided.

Maximum string length: 100

Response

Card terminated

success
boolean
Example:

true

status
integer
Example:

200

message
string
data
object
meta
object