CabFare Connect API
5 min
overview the cabfare connect api is the central api hosted by cabfare both the taxi meter partner and the payment terminal partner call these endpoints to send events to cabfare connect, initiate actions, and request subsidy calculations this api is the outbound communication path — your system calls cabfare connect design approach all endpoints in the cabfare connect api use post regardless of the nature of the request this is intentional and documented in the spec the api is not strictly restful but is designed for simplicity and speed of integration the api is event driven in most cases when your system sends a request to cabfare connect it will receive an immediate acknowledgement any further action is then triggered when your system receives an inbound event from cabfare connect, or via driver interaction on the device this design provides resilience against network dropouts and allows the driver to intervene at any point endpoint groups the cabfare connect api is organised into two groups based on the integration persona payment terminal endpoints — called by payment terminal partners method endpoint summary post /terminal/driver/poll check current driver and link status for the terminal post /terminal/driver/login notify cabfare connect of driver login on payment terminal ⚠️ post /terminal/driver/logout notify cabfare connect of driver logout on payment terminal post /terminal/driver/validate submit driver card validation from payment terminal post /terminal/link/request send a link mode request from payment terminal ⚠️ post /terminal/mptp/validate submit subsidy card validation from payment terminal post /terminal/payment/complete notify cabfare connect of payment outcome from payment terminal taxi meter endpoints — called by taxi meter partners method endpoint summary post /meter/driver/poll check current driver and link status for the meter post /meter/driver/login notify cabfare connect of driver login on taxi meter post /meter/driver/logout notify cabfare connect of driver logout on taxi meter post /meter/trip/start notify cabfare connect of trip start post /meter/trip/end submit fare details and request subsidy processing at trip end post /meter/mptp/read request subsidy card read on payment terminal post /meter/mptp/validate submit manual subsidy card number entry from taxi meter post /meter/payment/request request card payment from payment terminal post /meter/payment/cancel cancel a pending card payment request post /meter/job/done notify cabfare connect that all payments are complete and close the job testing endpoints method endpoint summary get / post /v0 5 0/ping connectivity test important notes for simplicity, all references to "terminal" in the spec refer to payment terminals and all references to "meter" refer to taxi meters at least one unique device identifier ( taximeterid or terminalid ) must be present in the majority of requests to identify the target device the driverid and vehicleplate may also be present as a means of targeting the correct terminal and confirming the driver remains logged in full endpoint schemas, request and response bodies, and error details are available in the interactive api reference imported from the openapi specification