Wallet, Ledger and Invoices

Your agency has one prepaid wallet, shared by the owner and all staff logins. Every API booking is paid in full from it. Top up on the agent panel (UPI or card), or send a bank transfer and EazyGo records it. Top-ups aren't possible through the API.

GET /wallet

{
  "success": true,
  "data": {
    "currency": "INR",
    "balance": 15000,
    "credit_limit": 0,
    "available": 15000
  }
}

available is what can be spent now: the balance plus any credit EazyGo allows your agency. A booking costing more than available is refused with INSUFFICIENT_BALANCE.

GET /wallet/transactions

The ledger, newest first. per_page is 1 to 100 (default 25), and page sets the page.

{
  "success": true,
  "data": [
    {
      "id": 9021,
      "type": "debit",
      "reason": "booking",
      "amount": 662,
      "balance_after": 14338,
      "booking_reference": "EZ7Q2K9P4XMA",
      "note": "Booking EZ7Q2K9P4XMA",
      "created_at": "2026-11-18T10:33:12+05:30"
    }
  ],
  "meta": { "current_page": 1, "per_page": 25, "total": 1, "last_page": 1 }
}

type is credit or debit. reason says why: topup, booking, refund or adjustment (a correction by EazyGo, with a note).

GET /bookings/{reference}/invoice

EazyGo's GST tax invoice to your agency, as a PDF (application/pdf). It is issued once per booking, when the trip is completed, with its own serial number (e.g. INV/2627/00042), your agency's GSTIN and place of supply, and IGST, or CGST and SGST, as applicable.

The wallet payment for a booking gets a receipt voucher straight away, and a refund gets a refund voucher (before the invoice) or a credit note (after it). Every booking lists its documents in documents (type: receipt, invoice, refund_voucher or credit_note, with number, issued_at and total); the receipts and refund documents can be downloaded on the agent panel.

curl -o invoice.pdf https://eazygo.in/api/agent/v1/bookings/EZ7Q2K9P4XMA/invoice \
  -H "Authorization: Bearer $EAZYGO_API_KEY"

Until the trip is completed the answer is 409 INVOICE_NOT_AVAILABLE.

EazyGo doesn't issue an invoice to your passenger. What you charge them, and invoice them for, is your business.

← Cancellations

Webhooks →