Disclaimer

This document is only collection of author’s notes, experiences and point of views. It is not, in any meaning, either complete description of the topic nor official RTB documentation. It may be inaccurate, incomplete, obsolete, misleading or completely wrong. It may even cause loss of data or damage system integrity. It may not comply with company codex, values, presentation style or economic interests or may reveal company secrets.

As such, it is absolutely prohibited to distribute this document outside of RTB & Co. GmbH. Such an action may result into legal acts against both the sender and the company. It is only intended, after review of technical and presentational correctness and accuracy, to be used as an information source for official documentation.

Always contact documentation department for information about current presentation style and allowed formats before creating customer’s documentation.

1. Overview

The document describes how the integration between PDM and Feratel is done. This integration allows to work with QR codes issued by Feratel in Austria. implementation is similar to Brain behind.

1.1. PDM

Handling of requests has been made via real time request framework developed earlier (Real time multi request). There is just one request to find out if the card is know to feratel and valid. In such a case PDM will switch some special tariff.

2. Card validity

2.1. Request

To find if the card is valid, it is necessary to provide the card id (KKN) and area (GAC) within real-time request number 24.

Card ID is string and leading zeroes matters. ID 123 ≠ 0123 ≠ 000123
Card validity request
PSA12;GAC11;MRQ[{REQ:24,KNN:"0178062140080254101"}];

2.2. Response

The response contains two interesting fields.

  • cardValid - string which indicates if the card is valid. "1" = valid, "0" = invalid, rest is undefined and should not happen.

  • cardNr - card number. It is something different then cardID.

  • ERC - error code. See chapter error codes.

Examples below demonstrates different response categories.

Valid card
 PSA00012;GAC11;MRQ[{cardValid:"1",ERC:0,cardNr:401393784,REQ:24}];...
Invalid card
 PSA00012;GAC11;MRQ[{cardValid:"0",cardNr:0,ERC:0,REQ:24}];...

Filed cardNr is equal to 0

API error
 PSA00012;GAC11;MRQ[{ERC:2,REQ:24}];...

Table of error codes is below in chapter error codes.

3. Error codes

Table 1. Standard Web API error codes
Error code Meaning

1

Service is disabled in PDM.control

2

Response can not be understand by our system. This is probably implementation error or changed API. Please contact help desk.

3

Web API did not understood request. See mnemonic ERM for details.

4

Web API understood the request but refused to fulfill it. See mnemonic ERM for details.