Member Card Validation
10 min
overview the member card validation workflow confirms that a passenger is eligible for subsidy scheme benefits before a subsidy scheme trip proceeds validation can be initiated by the payment terminal via a physical card read, or by the taxi meter via manual entry if the card cannot be read this workflow may occur at any point during the trip including at trip end sequence diagram sequencediagram actor driver participant tm as taxi meter participant cc as cabfare connect participant pt as payment terminal driver >>tm selects subsidy scheme trip on taxi meter tm >>cc post /meter/mptp/read (taximeterid, driverid, tripid) cc >>pt post /mptp/read (driverid, tripid) pt >>driver prompts driver to present subsidy card alt option a — payment terminal reads card successfully driver >>pt presents subsidy card pt >>cc post /terminal/mptp/validate (terminalid, driverid, tripid, cardnumber) cc >>cc validates card eligibility and balance alt card is valid cc >>pt 200 ok (mptpmemberdata, iseligible true) cc >>tm post /mptp/member (mptpmemberdata) tm >>driver displays validation success, initiates subsidy scheme trip else card is invalid cc >>pt 200 ok (mptpmemberdata, iseligible false) cc >>tm post /mptp/member (error details) tm >>driver displays error end else option b — payment terminal cannot read card, manual entry on taxi meter driver >>pt cancels card read driver >>tm selects manual entry, enters card number on keypad tm >>cc post /meter/mptp/validate (taximeterid, driverid, tripid, cardnumber) cc >>cc validates card eligibility and balance alt card is valid cc >>tm 200 ok (mptpmemberdata, iseligible true) tm >>driver displays validation success, initiates subsidy scheme trip else card is invalid cc >>tm 200 ok (mptpmemberdata, iseligible false) tm >>driver displays error end end step by step step 1 — driver selects subsidy scheme trip on taxi meter the driver selects the option on the taxi meter to initiate a subsidy scheme trip the taxi meter sends a card read request to cabfare connect taxi meter calls post /meter/mptp/read required fields taximeterid , driverid , tripid step 2 — cabfare connect forwards card read request to payment terminal cabfare connect forwards the card read request to the linked payment terminal cabfare connect calls post /mptp/read on the payment terminal the payment terminal prompts the driver to present the passenger's subsidy card step 3 — card read or manual entry option a — payment terminal reads card successfully the driver presents the passenger subsidy card to the payment terminal the payment terminal reads the card and submits it to cabfare connect for validation payment terminal calls post /terminal/mptp/validate required fields terminalid , driverid , tripid , card number option b — payment terminal cannot read card if the payment terminal cannot read the card the driver cancels the card read on the payment terminal the driver then selects manual entry on the taxi meter and enters the card number on the keypad the card number for manual entry is the last 9 digits of the subsidy card number the first 9 digits must not be included confirm whether this digit format applies generically or is specific to the victoria mptp implementation only taxi meter calls post /meter/mptp/validate required fields taximeterid , driverid , tripid , card number step 4 — cabfare connect validates the card cabfare connect checks the card against the current subsidy provider eligibility data if the card is valid and the member has a positive balance if the request came from the payment terminal cabfare connect returns validation success to the payment terminal cabfare connect sends the member card details to the taxi meter via post /mptp/member the taxi meter initiates the subsidy scheme trip if the request came from the taxi meter cabfare connect returns validation success and member card details to the taxi meter the taxi meter initiates the subsidy scheme trip if the card is invalid, expired, or has no remaining balance if the request came from the payment terminal cabfare connect returns error details to the payment terminal for display cabfare connect sends error details to the taxi meter via post /mptp/member if the request came from the taxi meter cabfare connect returns error details to the taxi meter for display step 5 — additional subsidy cards cabfare connect supports multiple subsidy cards within a single trip for additional lifting fees this process may be repeated for each additional eligible passenger only the first subsidy card is used to process the subsidy payment additional cards are validated and recorded for lifting fee purposes only key points member card validation may occur at any point during the trip including at trip end the taxi meter is the designated entry point for manual card number entry if the payment terminal cannot read the card if the card is invalid the driver must find an alternative method — the trip may continue as a standard trip multiple subsidy cards may be added to a single trip for additional lifting fees only the first subsidy card submitted is used to calculate the subsidy payment