curl -X PUT 'https://api.yativo.com/api/v1/customer/virtual/cards/update/card_01HX9KZMB3F7VNQP8R2WDGT4E5' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: freeze-card-001' \
-d '{ "action": "freeze" }'
curl -X PUT 'https://api.yativo.com/api/v1/customer/virtual/cards/update/card_01HX9KZMB3F7VNQP8R2WDGT4E5' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: freeze-card-001' \
-d '{ "action": "unfreeze" }'
{
"action": { ... }
}
Virtual Cards
Freeze / Unfreeze Card
Temporarily freeze or unfreeze a virtual card
PUT
/
customer
/
virtual
/
cards
/
update
/
{card_id}
curl -X PUT 'https://api.yativo.com/api/v1/customer/virtual/cards/update/card_01HX9KZMB3F7VNQP8R2WDGT4E5' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: freeze-card-001' \
-d '{ "action": "freeze" }'
curl -X PUT 'https://api.yativo.com/api/v1/customer/virtual/cards/update/card_01HX9KZMB3F7VNQP8R2WDGT4E5' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: freeze-card-001' \
-d '{ "action": "unfreeze" }'
{
"action": { ... }
}
Freeze or unfreeze a virtual card. A frozen card declines all transactions until it is unfrozen.
PUT https://api.yativo.com/api/v1/customer/virtual/cards/update/{card_id}
Requires an
Idempotency-Key header.curl -X PUT 'https://api.yativo.com/api/v1/customer/virtual/cards/update/card_01HX9KZMB3F7VNQP8R2WDGT4E5' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: freeze-card-001' \
-d '{ "action": "freeze" }'
curl -X PUT 'https://api.yativo.com/api/v1/customer/virtual/cards/update/card_01HX9KZMB3F7VNQP8R2WDGT4E5' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: freeze-card-001' \
-d '{ "action": "unfreeze" }'
{
"action": { ... }
}
Authorizations
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
Your API secret (yativo_sk_...), shown once when the key is created.
Headers
A unique string per request to ensure idempotent processing.
Path Parameters
The virtual card ID.
Body
application/json
"freeze" to block the card, or "unfreeze" to re-enable it.
Available options:
freeze, unfreeze Response
Card status updated
The response is of type object.