Trip End

overview the trip end workflow finalises the passenger hire the driver ends the trip on the taxi meter, which calculates all fare details and submits them to cabfare connect for subsidy scheme trips cabfare connect processes the subsidy payment and returns the subsidy amount and remaining passenger payable balance to both devices the workflow then proceeds to balance payment to collect any remaining amount once all payments are complete the taxi meter closes the job and cabfare connect reports the trip data to the subsidy provider sequence diagram sequencediagram actor driver participant tm as taxi meter participant cc as cabfare connect participant pt as payment terminal driver >>tm ends trip on taxi meter tm >>driver driver sets all fare details and extras alt subsidy scheme trip tm >>cc post /meter/trip/end (taximeterid, driverid, tripid, tripdetails, faredetails) cc >>cc processes subsidy payment against member account alt subsidy payment successful cc >>tm 200 ok (mptpsubsidypaid, remainingbalance, subsidystatus) cc >>pt updates payment terminal with subsidy and balance details tm >>driver displays remaining balance due else subsidy payment failed cc >>tm 200 ok (subsidystatus failed, error details) tm >>driver displays error, driver takes appropriate next steps end else standard trip tm >>driver displays full fare as balance due end note over tm,pt proceed to balance payment workflow tm >>cc post /meter/job/done (taximeterid, driverid, tripid, paymentdetails) cc >>cc sends trip data to subsidy provider alt taxi meter printer configured tm >>driver prints receipt including subsidy details else payment terminal printer configured cc >>pt post /print/receipt (tripdetails, subsidydetails, paymentdetails) pt >>driver prints receipt including subsidy details end step by step step 1 — driver ends trip on taxi meter the driver ends the hire by stopping the trip on the taxi meter as normal the driver sets all relevant fare details on the taxi meter including any applicable extras step 2 — subsidy scheme trip processing if the current trip is a valid subsidy scheme trip the taxi meter submits the fare details to cabfare connect for subsidy processing taxi meter calls post /meter/trip/end required fields taximeterid , driverid , vehicleplate , tripid , tripdetails , faredetails the faredetails must include all fare components — base fare, any surcharges, extras, lifting fees, and subsidy scheme member details all monetary amounts must be expressed in cents as integers the extras and surcharges eligible to be included in the fare submitted to cabfare connect are defined by the subsidy provider for your location refer to the relevant location section for a complete list of eligible extras applicable to your integration the taxi meter is the regulated fare calculation device and is responsible for all fare calculations cabfare connect is responsible only for processing the subsidy payment amount as requested by the taxi meter if the subsidy payment is successful cabfare connect returns the subsidy amount paid, the remaining passenger payable balance, and the subsidy status to the taxi meter cabfare connect updates the payment terminal with the subsidy and balance details the taxi meter displays the remaining balance due to the driver if the subsidy payment fails cabfare connect returns an error response to the taxi meter the taxi meter displays an error message and the driver takes appropriate next steps, such as manual processing step 3 — standard trip if the current trip is not a subsidy scheme trip the taxi meter displays the full fare as the balance due no subsidy processing occurs the workflow proceeds directly to balance payment step 4 — balance payment once the remaining balance is known the workflow proceeds to the balance payment workflow the driver selects the payment method on the taxi meter and collects the remaining amount from the passenger by card, cash, or other method refer to the balance payment workflow for the full step by step step 5 — taxi meter closes the job once all payments are complete the driver presses done on the taxi meter the taxi meter sends a job complete notification to cabfare connect including all payment details taxi meter calls post /meter/job/done required fields taximeterid , driverid , tripid , payment details cabfare connect sends all required trip and shift information to the subsidy provider step 6 — receipt if the system is configured with a taxi meter printer the taxi meter prints a receipt including subsidy payment details if the system is configured with a payment terminal printer cabfare connect sends the trip, subsidy, and payment details to the payment terminal for printing cabfare connect calls post /print/receipt on the payment terminal includes trip details, subsidy details, payment details key points the taxi meter is the regulated fare calculation device — cabfare connect does not calculate fares all monetary amounts must be expressed in cents as integers post /meter/job/done must always be called to close the trip and trigger subsidy provider reporting if issubsidycalculationmatching returns false in the trip end response, treat the cabfare connect returned values as the source of truth for subsidy scheme trips the subsidy amount and remaining balance are returned by cabfare connect — the taxi meter must use these values for the balance payment step eligible extras and surcharges are defined by the subsidy provider for your location — refer to the relevant location section