Skip to main content
POST
/
api
/
v1
/
cards
/
{card_id}
/
lock
Lock Card
curl --request POST \
  --url https://api.usezentra.com/api/v1/cards/{card_id}/lock \
  --header 'Authorization: Bearer <token>'

​
Lock Card

Lock a card through the reviewed public gateway. This is the current public equivalent of older freeze card terminology.

​
Endpoint

POST /api/v1/cards/{card_id}/lock

​
Path Parameters

​
card_id
string
required
The card identifier returned during card creation or listing.

​
Request Body

This operation accepts an optional JSON body. If you send metadata, keep it stable and auditable. Common examples include:
  • reason
  • request_id
  • idempotency_key

​
Example Request

curl -X POST https://api.usezentra.com/api/v1/cards/card_123/lock \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "suspected_fraud",
    "request_id": "lock_card_123_001"
  }'

​
Response Notes

  • The reviewed public OpenAPI models this as an accepted async-style operation.
  • For longer-lived policy changes, use the security settings endpoint as well.

​
Next Steps

Unlock Card

Restore card usage when review is complete

Security Settings

Review broader card controls