Skip to main content
GET
/
api
/
v1
/
cards
/
{card_id}
/
auto-reload
Manage Auto-Reload
curl --request GET \
  --url https://api.usezentra.com/api/v1/cards/{card_id}/auto-reload \
  --header 'Authorization: Bearer <token>'

​
Manage Auto-Reload

Read or update auto-reload settings for a card.

​
Endpoints

GET /api/v1/cards/{card_id}/auto-reload
PUT /api/v1/cards/{card_id}/auto-reload

​
Path Parameters

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

​
Update Request Body

The reviewed public contract currently accepts a flexible JSON object for auto-reload settings. Typical fields include:
  • enable or disable state
  • threshold amount
  • top-up amount
  • optional funding source or correlation metadata
Confirm your exact allowed payload with your approved product configuration before going live.

​
Example Update Request

curl -X PUT https://api.usezentra.com/api/v1/cards/card_123/auto-reload \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "threshold_minor": 200000,
    "reload_amount_minor": 500000
  }'

​
Response Notes

  • Reads return the current auto-reload configuration for the card.
  • Updates are tenant-scoped and should be treated as configuration changes, not immediate funding events.

​
Next Steps

JIT Fund Card

Trigger just-in-time funding when needed

Fund Card

Add balance directly to the card