Skip to main content

Retail Transactions

The retail transaction model is an "online" model where processing is done immediately after the validation of the card. If validation fails then entry/ticket purchase for the cardholder is denied. If validation is successful then entry/ticket purchase for the cardholder is allowed.

    Following transactionData.transactionType values can be used:

   - RETAIL_PAYMENT
   - RETAIL_REFUND

Sfey internal processing:

  • For every successful authorization corresponding message is added to the clearing.
  • If authorization is cancelled with a reversal request (partially or fully) then corresponding reversal message is added to the clearing.

Retail Check-In & Check-Out Transactions​

The retail check-in & check-out model is similar to the simple Retail model. However, the cardholder has to validate the payment card two times - when starting the travel period & when ending the travel period.

Check-in:

  • transactionData.transactionType value RETAIL_CHECK_IN
  • Amount: initital amount to be pre-authorised

Check-out:

  • transactionData.transactionType value RETAIL_CHECK_OUT
  • transactionData.initialTransactionUuid corresponsding to the initial check-in transaction UUID
  • Amount: final amount

Two different check-in & check-out implementations can be used:​

  1. Biggest possible ticket price charged from the cardholder during check-in - lower risks but less comfortable for the traveller

  2. Most possible ticket price charged from the cardholder during check-in - higher risks but more comfortable for the traveller

If the check-out amount is smaller than the check-in amount then a reversal will be done and the exceeding money will be returned to the cardholder.

If the check-out amount is bigger than the check-in amount then an incremental authorisation will be done for the exceeding amount.

Sfey internal processing:​

  • For all pre-authorizations made with the same card, TPS sends one clearing message for the total amount.
  • If for some reason a successful pre-authorization was canceled with a reversal (either partially or fully), this will affect the total amount of the message given in the previous point. No separate reversal messages will be sent to clearing.
  • If a successful pre-authorization is fully canceled with the reversal then TPS will not add reversal messages to the clearing.

💬 What happens if the cardholder forgets to do a check-out tap or it fails?​

There are two possibilities if TPS does not receive the check-out tap (e.g. the cardholder forgets to make a check-out tap). Configurable on the TPS side for every organization:

  1. TPS will automatically charge the maximum price specified in the check-in request.

  2. TPS will refund the whole check-in amount. .

           Following transactionData.transactionType values can be used:

       - RETAIL_CHECK_IN
       - RETAIL_CHECK_OUT
       - RETAIL_REFUND