Skip to main content
GET
/
api
/
v1
/
cards
/
{card_id}
/
security
Manage Card Security Settings
curl --request GET \
  --url https://api.usezentra.com/api/v1/cards/{card_id}/security \
  --header 'Authorization: Bearer <token>'

​
Manage Card Security Settings

Read or update card security controls through the reviewed public gateway.

​
Endpoints

GET /api/v1/cards/{card_id}/security
PUT /api/v1/cards/{card_id}/security

​
Path Parameters

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

​
Update Request Body

The reviewed public contract accepts a flexible JSON object for card security settings. Depending on your card program, that may include:
  • spending limits
  • channel or merchant controls
  • geofencing or travel controls
  • other card-level safety settings
Confirm the exact supported keys for your program before relying on unapproved fields.

​
Example Update Request

curl -X PUT https://api.usezentra.com/api/v1/cards/card_123/security \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "spending_limits": {
      "daily_minor": 2500000,
      "monthly_minor": 10000000
    },
    "merchant_controls": {
      "blocked_categories": ["gambling"]
    }
  }'

​
Response Notes

  • GET returns the currently applied security configuration for the card.
  • PUT updates those controls and returns the updated configuration.
  • Lock and unlock are exposed as separate operational endpoints.

​
Next Steps

Lock Card

Temporarily lock card usage

Unlock Card

Restore card usage after review