MPTP Data Fields
3 min
overview to ensure compliance with safe transport victoria (stv), all mptp related data submitted to cabfare connect must adhere to a strict schema whether data is captured via a physical card read on the eftpos terminal or manual entry on the taxi meter, it must be mapped to the fields defined on this page mptp member object when validating a member via /terminal/mptp/validate or /meter/mptp/validate , the system expects and returns the following core data points field type description requirement membernumber string the unique 9 digit identifier found on the passenger's stv card required iseligible boolean returns true if the member has a valid account and available subsidy balance returned by cabfare connect expirydate string the card expiry in yyyy mm dd format transactions cannot proceed if the card is expired required subsidypercentage integer the percentage of the fare covered by stv (typically 50%) returned by cabfare connect subsidycap integer the maximum amount in cents covered per trip (typically 6000, equivalent to $60 00) returned by cabfare connect driver mptp data when a driver logs in, cabfare connect returns the driver's current mptp registration status in the mptpdriverdata object field type description mptpstatus string the driver's current mptp eligibility status mptp driver invalid indicates the driver is not registered or not currently permitted to provide mptp trips mptpnumber string the driver's mptp registration number only present if the driver is registered mptpexpiry string the driver's mptp registration expiry date in yyyy mm dd format only present if the driver is registered if mptpstatus is mptp driver invalid , subsidy scheme trip functions must be disabled for the shift standard trips continue normally critical validation rules manual entry format if entering a member number manually on the taxi meter, the system strictly accepts the last 9 digits of the card number only the first 9 digits of the card number must not be included currency format all fare related fields including subsidycap are expressed in cents as integers a $60 00 cap is represented as 6000 eligibility check a trip must not be initiated as an mptp trip unless iseligible returns true during the validation check expired or cancelled cards a subsidised fare must not be processed for a member whose mptp card has been rejected as expired or cancelled