Skip to main content
Freeze or unfreeze a virtual card. A frozen card declines all transactions until it is unfrozen. 
PUT /customer/virtual/cards/update/{cardId}

​
Path Parameters

​
cardId
string
required
The virtual card ID.

​
Request Body

​
action
string
required
"freeze" to block the card, or "unfreeze" to re-enable it.
curl -X PUT 'https://api.yativo.com/api/v1/customer/virtual/cards/update/card_01HX9KZMB3F7VNQP8R2WDGT4E5' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: unique-key-here' \
  -d '{ "action": "freeze" }'

{
  "status": "success",
  "status_code": 200,
  "message": "Card frozen successfully",
  "data": {
    "card_id": "card_01HX9KZMB3F7VNQP8R2WDGT4E5",
    "status": "frozen"
  }
}