Skip to main content
DELETE
/
cards
/
{cardId}
Terminate Card
curl --request DELETE \
  --url https://api.fyatu.com/api/v3/cards/{cardId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "Card reported lost by customer",
  "reference": "cancel-card-abc123"
}
'
{
  "success": true,
  "status": 200,
  "message": "Card terminated successfully",
  "data": {
    "id": "crd_8f3a2b1c4d5e6f7890abcdef12345678",
    "status": "TERMINATED",
    "reason": "Card reported lost by customer",
    "refundedBalance": 45.5,
    "terminatedAt": "2026-01-17T10:00:00+00:00",
    "reference": "cancel-card-abc123"
  },
  "meta": {
    "requestId": "req_a1b2c3d4e5f6",
    "timestamp": "2026-01-17T10:00:00+00:00"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Permanently terminate a card. The card is immediately declined for all future transactions. Any remaining card balance is returned to your business wallet.

​
Path Parameters

ParameterTypeDescription
cardIdstringThe card ID

​
Behavior

  • Card status changes to TERMINATED immediately
  • All future transactions are declined
  • Remaining balance is credited back to your business wallet
  • The card cannot be reactivated — issue a new card if needed

​
Error Codes

CodeDescription
RESOURCE_NOT_FOUNDCard not found or belongs to another business
CARD_ALREADY_TERMINATEDCard is already terminated
Card termination is irreversible. Ensure the cardholder is informed before terminating their card.

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