# Wallet and GST Invoices

> The Edesy prepaid INR wallet - Razorpay top-ups, real-time call deduction, GST invoices with your GSTIN for input tax credit, transaction export and number rentals.

Source: https://edesy.in/docs/voice-api/account/wallet-and-gst-invoices

The Voice API is prepaid. You top up an INR wallet with Razorpay, and calls, number rentals and other usage are deducted in real time. Every top-up gets a GST invoice (PDF, and emailed), and if you add your GSTIN to the billing profile it appears on the invoice so you can claim input tax credit. There is no minimum commitment.

## How charges work

| Charge | When it is deducted |
|---|---|
| Call minutes | As calls complete, at Rs 0.50 per minute with a 60-second pulse. Unanswered calls are free |
| Premium TTS | With the call, Rs 0.03 per character |
| Number rental | At purchase and on each renewal |
| Extra channels or calls per second | When you buy the add-on in Billing |

Prices exclude 18% GST. If the balance is too low, new calls are refused with `402 INSUFFICIENT_BALANCE` and number purchases fail the same way. Keep a buffer above your daily spend.

## Top up

Top up from the Billing page of [voice-app.edesy.in](https://voice-app.edesy.in). Payment runs through Razorpay checkout (UPI, cards, netbanking as offered by Razorpay), and the balance updates as soon as the payment is verified.

## Billing endpoints

| Method | Path | Description |
|---|---|---|
| `GET` | `/v1/billing` | Wallet balance and billing summary |
| `GET` | `/v1/billing/transactions` | Wallet transactions |
| `GET` | `/v1/billing/transactions.csv` | Transactions as CSV, for your accounts team |
| `GET` | `/v1/billing/rentals` | Number rentals and their renewal dates |
| `GET` | `/v1/billing/invoices` | GST invoices |
| `GET` | `/v1/billing/payments/{id}/invoice` | One invoice as PDF |
| `POST` | `/v1/billing/payments/{id}/invoice/email` | Email an invoice |
| `GET` / `PUT` | `/v1/billing/profile` | Billing profile |
| `GET` | `/v1/billing/tax-config` | Tax settings applied to your invoices |

## Billing profile and GSTIN

```bash
curl -X PUT https://voice-api.edesy.in/v1/billing/profile \
  -H "Authorization: Bearer $EDESY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "legal_name": "Acme Retail Private Limited",
    "gstin": "27ABCDE1234F1Z5",
    "address_line1": "Unit 4, Example Park",
    "city": "Pune",
    "state": "Maharashtra",
    "pincode": "411001",
    "email": "accounts@example.com"
  }'
```

Set the profile before you top up so the invoice carries your legal name, GSTIN and address.

## Per-call cost

Each call's charge is on the call object as `price` (`amount`, `currency`). `GET /v1/calls/summary` returns the count, total price and total duration for any filter, for example a month:

```bash
curl "https://voice-api.edesy.in/v1/calls/summary?start_date=2026-10-01T00:00:00Z&end_date=2026-11-01T00:00:00Z" \
  -H "Authorization: Bearer $EDESY_KEY"
```

See [Pricing and Limits](https://edesy.in/docs/voice-api/getting-started/pricing-and-limits).