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.