Cancelling a Booking

A booking can be cancelled until its trip has started. The money paid from your wallet goes back to the wallet straight away, less the cancellation charge.

Cancellation charges

EazyGo's cancellation charges depend on how long before pickup you cancel, e.g. "less than 24 hours before pickup: 25% of the booking". The tightest matching rule applies, and cancelling well ahead is usually free. Always check with the endpoint below rather than working the charge out yourself.

GET /bookings/{reference}/cancellation

What cancelling now would cost, without cancelling.

{
  "success": true,
  "data": {
    "reference": "EZ7Q2K9P4XMA",
    "cancellable": true,
    "charge": 165.38,
    "refund_to_wallet": 496.12
  }
}

charge and refund_to_wallet are null when the booking can't be cancelled any more (already cancelled, or the trip has started or finished).

POST /bookings/{reference}/cancel

Cancels the booking and refunds the wallet. No body is needed.

curl -X POST https://eazygo.in/api/agent/v1/bookings/EZ7Q2K9P4XMA/cancel \
  -H "Authorization: Bearer $EAZYGO_API_KEY"
{
  "success": true,
  "message": "Booking cancelled. ₹496.12 is back in your wallet.",
  "data": {
    "reference": "EZ7Q2K9P4XMA",
    "status": "cancelled",
    "...": "...",
    "refunded_to_wallet": 496.12
  }
}

Cancelling twice is safe. The second request returns 409 NOT_CANCELLABLE and refunds nothing more.

HTTP error Meaning
404 BOOKING_NOT_FOUND No booking with this reference for this key
409 NOT_CANCELLABLE Already cancelled, or the trip has started or finished
500 CANCEL_FAILED The refund didn't go through, so the booking stays as it was. Try again or contact support

The passenger, and the driver if one was assigned, are told about the cancellation automatically.

Sign in with Mobile
Enter your mobile number to receive OTP