EFTPOS Transit Rules
Overview
The aggregation model applies when the final fare is not known at the time of travel. The system calculates the fare at the end of a predefined travel period, typically 24 hours, based on the journeys made during that period.
You can charge flat, distance-based, or time-based fares for each trip within the travel period.
Familiarize yourself with the scheme rules and comply with all requirements.
| Use case | Supported |
|---|---|
| Aggregated transit rules | Yes |
Known Fare transit rules
|
Yes |
| Merchant-initiated debt recovery | Yes |
| Payer-initiated debt recovery: e-commerce | Yes |
| Tap-initiated debt recovery | Yes |
| First ride risk | Yes |
| Application transaction counter | No |
API version and parameters
Mastercard Gateway supports transit aggregation on PAY in WS API version 100 and later.
posTerminal parameters
This table describes the most common posTerminal parameters.
| WS API field | Value |
|---|---|
| cardPresenceCapability | CARD_PRESENT |
| attended | UNATTENDED |
| cardholderActivated | NOT_CARDHOLDER_ACTIVATED |
| 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 |
| pinEntryCapability | PIN_NOT_SUPPORTED |
| panEntryMode | CONTACTLESS |
| onlineReasonCode | N/A |
transaction.transit.aggregatedFare parameter group
Aggregation also requires the transaction.transit.aggregatedFare parameter group.
| WS API field | Value |
|---|---|
.type |
|
.aggregationStartDate |
Date of first trip in YYYY-MM-DD format |
.transportationMode |
|
.referenceOrderId |
Order ID of the related previous transaction |
Prerequisites
Your payment service provider must enable you to retrieve unmasked card numbers.
Aggregation and known fare use cases
Aggregated transit fare payments include these use cases.
Aggregated fare rules:- First tap within the travel period
- Subsequent taps within the travel period
- End of travel period
- Merchant-initiated debt recovery
- Payer-initiated or tap-initiated debt recovery
- First ride risk
- Real time known fare
- Deferred known fare
- Merchant-initiated debt recovery
- Payer-initiated or tap-initiated debt recovery
- First ride risk