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

​
JIT Fund Card

Trigger a just-in-time funding flow for a card.

​
Endpoint

POST /api/v1/cards/{card_id}/jit-fund

​
Path Parameters

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

​
Request Body

The reviewed public contract accepts a flexible JSON payload here. In practice, you should include stable request identity and the funding context required by your card program. Recommended fields:
  • amount_minor
  • currency
  • transaction_reference
  • idempotency_key

​
Example Request

curl -X POST https://api.usezentra.com/api/v1/cards/card_123/jit-fund \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount_minor": 500000,
    "currency": "NGN",
    "transaction_reference": "jit_fund_card_123_001",
    "idempotency_key": "jit_fund_card_123_001"
  }'

​
Response Notes

  • This is an accepted async-style operation on the reviewed public contract.
  • Use a stable business reference and idempotency key for retries.

​
Next Steps

Fund Card

Directly top up the card balance

Auto-Reload

Configure automatic reload behavior