Known Fare
Known fare transactions are where the transaction amount is known and authorization for the full amount is requested at the time of travel.
API version
For Known Fare, API from version 66 onwards is required.
posTerminal parameters
This table describes the most common posTerminal parameters.
WS API Field | Value |
---|---|
cardPresenceCapability | CARD_PRESENT |
Attended | UNATTENDED |
cardholderActivated | SELF_SERVICE_TERMINAL |
Location | MERCHANT_TERMINAL_ON_PREMISES |
Lane | Use a unique Terminal ID for the device.
Do not use a fixed Terminal ID value across the estate. |
inputCapability | CONTACTLESS_CHIP |
pinEntry capability | PIN_NOT_SUPPORTED |
panEntryMode | CONTACTLESS |
onlineReasonCode |
Different values maybe required, depending on the specific implementation.
transaction.transit.knownFare parameters
Additionally, the transaction.transit.knownFare parameter is required for known fare transactions
WS API Field | Value |
---|---|
.type | FARE_REAL_TIME_AUTHORIZATION |