Trip Start
7 min
overview the trip start workflow begins a new passenger hire the taxi meter notifies cabfare connect that a trip has commenced and receives a trip id that is used as the unique identifier for all subsequent events in that hire trip start applies to both standard and subsidy scheme trips sequence diagram sequencediagram actor driver participant tm as taxi meter participant cc as cabfare connect driver >>tm starts trip hire on taxi meter tm >>cc post /meter/trip/start (taximeterid, driverid, vehicleplate, tripid) alt driver is eligible for subsidy scheme trips cc >>tm 204 no content (trip started, mptp status valid) else driver is not eligible for subsidy scheme trips cc >>tm 202 accepted (trip started, mptp status invalid) tm >>driver disables subsidy scheme functions for this trip end step by step step 1 — driver starts trip on taxi meter the driver begins the hire by starting the trip on the taxi meter as normal the taxi meter sends a trip start notification to cabfare connect taxi meter calls post /meter/trip/start required fields taximeterid , driverid , vehicleplate , tripid the tripid may be generated by the taxi meter or by cabfare connect if the taxi meter does not generate a tripid , cabfare connect will generate one and return it in the response the tripid must be used as the identifier for all subsequent events in this hire including member card validation, trip end, and balance payment step 2 — cabfare connect responds if the driver is eligible for subsidy scheme trips cabfare connect returns 204 no content the trip is active and subsidy scheme functions are available if the driver is not eligible for subsidy scheme trips cabfare connect returns 202 accepted the trip is active but subsidy scheme functions are disabled for this trip the taxi meter should update its display to reflect that subsidy scheme processing is not available step 3 — trip is active the trip is now active depending on the trip type the workflow continues as follows subsidy scheme trip — proceed to the member card validation workflow to validate the passenger subsidy card standard card payment trip — proceed directly to trip end when the passenger reaches their destination cash or other payment trip — proceed directly to trip end when the passenger reaches their destination key points the tripid must be unique per trip — do not reuse tripid values from previous trips if a 409 conflict is returned, a trip is already active for this vehicle — ensure the previous trip has been closed via /meter/job/done before starting a new one the tripid must be consistent across all subsequent api calls for this hire trip start applies to both standard and subsidy scheme trips — the trip type is determined by subsequent actions, not at trip start