Roles and Responsibilities

Taxi Meter / Dispatch Partner

Your system is responsible for:

Notifying CabFare Connect of driver login and logout events
Initiating and closing trips
Calculating all regulated fare amounts — CabFare Connect does not perform fare calculation
Submitting fare and Subsidy Scheme details to CabFare Connect at trip end and determining the payment method for the remaining balance
Requesting card payments from the Payment Terminal via CabFare Connect
Hosting inbound event endpoints to receive notifications from CabFare Connect
Handling manual Subsidy Card number entry if the Payment Terminal cannot read a card

Your system is responsible for:

Notifying CabFare Connect of driver login and logout events
Initiating the device link to establish a synchronised session with the Taxi Meter
Reading physical Subsidy Cards and submitting them to CabFare Connect for validation
Processing card payments for the balance amount instructed by CabFare Connect
Reporting payment outcomes (approved or declined) back to CabFare Connect
Hosting inbound event endpoints to receive notifications from CabFare Connect

Both partners are responsible for:

Handling network connectivity issues and timeouts gracefully
Implementing retry logic for failed or unacknowledged events
Returning an immediate 200 OK or 204 No Content upon receiving inbound events to prevent CabFare Connect from timing out
Maintaining consistent identifiers (driverId, vehiclePlate, taxiMeterId, terminalId) across all API calls within a session