Billing & Credits

Setara uses a simple fiat credit system. No tokens, no cryptocurrency — just INR credits.

How Credits Work

1 credit = 1 INR (Indian Rupee). Credits are a direct fiat equivalent — no exchange rates, no volatility.

1 document registration = 1 credit (configurable per organization via credit_rate).

Document verification is always free. The GET /api/v1/verify endpoint is public and requires no authentication or credits.

Credits are deducted automatically on each successful document registration. No billing cycle, no surprise charges.

Free Credits

Every new organization receives 5,000 free credits on registration — enough to register 5,000 documents before needing a top-up.

Free credits are applied instantly on signup
They work on both testnet and mainnet
No credit card required to get started
Credits do not expire

Checking Your Balance

Use the wallet endpoint to retrieve your current credit balance at any time:

bash

curl https://api.setara.network/api/v1/me/wallet \
  -H "X-API-Key: sk_your_api_key"

Response (200):

json

{
  "credits": 4850,
  "org_id": "abc123def456...",
  "org_name": "My Organization"
}

You can also view transaction history at GET /api/v1/me/transactions to see a full ledger of credits earned and spent. See the API Reference for the full response shape.

Adding Credits

Credits are managed by the Setara super admin. To top up your organization's balance:

Email support@setara.network with the amount and your org ID
Or contact your dedicated account manager if you have one
Payment is processed via Razorpay or bank transfer (INR)

Admin API endpoint (for reference):

bash

POST /api/v1/admin/wallets/{org_id}/credit

{
  "credits": 10000,
  "reference": "Razorpay payment #pay_abc123"
}

This endpoint requires the X-Admin-Secret header and is only accessible to Setara administrators.

What Happens at Zero Credits

If your organization runs out of credits, the API will return a 402 insufficient_credits error on any new document registration attempt. Here is what remains unaffected:

✓

Existing documents remain on-chain and are permanently accessible

✓

Verification continues to work — it is free and has no credit requirement

✓

No data is deleted — the blockchain is immutable

New registrations are blocked until credits are topped up

API Reference →

Error Codes →