Payment Service provider API ISO8583_2 ( IFSF) H2H description
Data element name
INDOOR TRANSACTIONS
FINANCIAL TRANSACTION REQUEST 1200
Fields not described on the below table are not supported by PayEx
Element number | Data element name | Presence | Format | Type | Size | Usage notes |
2 | PAN | C | LL | ans | ..19 | Present if manual PAN key entry. |
3 | Processing Code | M |
| n | 6 |
|
4 | Amount, transaction | M |
| n | 12 |
|
7 | Date and time, transmission | M | MMDDh hmmss | n | 10 |
|
11 | Systems trace audit number | M |
| n | 6 | Assigned by third party host |
12 | Date and time, local transaction | M | YYMMD Dhhmms s | n | 12 |
|
14 | Date expiry | C | YYMM | n | 4 | Only present for manual PAN keyentry. |
22 | Point of service data code | M |
| an | 12 |
|
24 | Function code | M |
| n | 3 |
|
25 | Message reason code | M |
| n | 4 |
|
26 | Card acceptor business code | M |
| n | 4 | 5541 for indoor and 5542 for outdoor. |
32 | Acquiring institution identification code | M | LL | n | ..11 | Contains ISO country code. |
33 | Forwarding Institution identification code | O | LL | n | ..11 | Required in concentrator model |
35 | Track 2 data | C | LL | ns | ..37 | Mandatory unless it’s a pan key entry transaction |
41 | Card acceptor terminal identification | M |
| ans | 8 |
|
42 | Card acceptor identification code | M |
| ans | 15 | 8 digit number assigned by PayEx |
43 | Card acceptor name / location | M |
| ans | ..999 |
|
48 | Message control data elements | M | LLL | ans | ..999 |
|
48-0 | Bit map | M |
| b | 8 |
|
48-4 | Batch/sequence number | M |
| n | 10 | Assigned by 3rd party |
48-8 | Customer data | C | LLL | ans | ..250 | Only present if customer data entered. As specified in [1] |
48-9 | Track II of vehicle card | O | LL | ns | ..37 |
|
48-14 | PIN Encryption Methodology | C |
| ans | 2 | Mandatory if online PIN, and must have value 33. |
48-32 | VAT Percentages | M | LL | ans | ..91 |
|
48-37 | Vehicle identification entry mode | O |
| ans | 1 |
|
48-38 | Pump linked indicator | O |
| n | 1 |
|
48-39 | Delivery note number | O |
| n | 10 | POS ticket number |
49 | Currency code, transaction | M |
| an | 3 |
|
52 | PIN Data | C |
| b | 8 | Only for Online PIN |
53 | Security Related Control Information | M | LL | b | ..48 |
|
59 | Transport Data | M | LLL | ans | ..999 | Ref.13.25 |
63 | Product data | M | LLL | ans | ..999 |
|
64 | MAC | M |
| b | 8 |
|
FINANCIAL TRANSACTION RESPONSE 1210
The following fieds listed below are supported in the response message. Fields not listed are not supported.
Element number | Data element name | Presence | Format | Type | Size | Usage notes |
3 | Processing Code | ME |
| n | 6 |
|
4 | Amount, transaction | M |
| n | 12 |
|
7 | Date and time, transmission | M | MMDDh hmmss | n | 10 |
|
11 | Systems trace audit number | ME |
| n | 6 |
|
12 | Date and time, local transaction | ME | YYMMD Dhhmm ss | n | 12 |
|
32 | Acquiring institution identification code | ME | LL | n | ..11 |
|
38 | Approval code | C |
| anp | 6 | Present if transaction approved |
39 | Action code | M |
| n | 3 |
|
41 | Card acceptor terminal identification | ME |
| ans | 8 |
|
42 | Card acceptor identification code | ME |
| ans | 15 |
|
48 | Message control data elements | M | LLL | ans | ..999 |
|
48-0 | Bit map | M |
| b | 8 |
|
48-4 | Batch/sequence number | ME |
| n | 10 |
|
49 | Currency code, transaction | ME |
| an | 3 |
|
53 | Security Releated Control Info | M | LL | b | ..48 |
|
59 | Transport Data | ME | LLL | ans | ..999 | Ref.13.25 |
62 | Product sets | C | LLL | ans | ..999 |
|
62-1 | Allowed product sets | C | LL | ans | ..99 |
|
62-2 | Device type | O |
| n | 1 |
|
62-3 | Message text | O | LLL | ans | ..894 |
|
64 | MAC | M |
| b | 8 |
|
FINANCIAL TRANSACTION ADVICE 1220/1221
Fields not described on the below table are not supported by OASE.
Element number | Data element name | Presence | Format | Type | Size | Usage notes |
2 | PAN | C | LL | ans | ..19 | Present if manual PAN key entry |
3 | Processing Code | M |
| n | 6 |
|
4 | Amount, transaction | M |
| n | 12 |
|
7 | Date and time, transmission | M | MMDDh hmmss | n | 10 |
|
11 | Systems trace audit number | M |
| n | 6 | Assigned by third party host |
12 | Date and time, local transaction | M | YYMMD Dhhmms s | n | 12 |
|
14 | Date expiry | C | YYMM | n | 4 | Present if manual PAN key entry |
22 | Point of service data code | M |
| an | 12 |
|
24 | Function code | M |
| n | 3 | Fixed 200: Original Financial Transaction Advice |
25 | Message reason code | M |
| n | 4 | 1003: Card Issuer Unavailable |
6 | Card acceptor business code | M |
| n | 4 | 5541 for indoor and 5542 for outdoor. |
32 | Acquiring institution identification code | M | LL | n | ..11 | Contains ISO country code |
33 | Forwarding Institution identification code | O | LL | n | ..11 | Required in concentrator model |
35 | Track 2 data | C | LL | ns | ..37 |
|
38 | Approval Code | M |
| anp | 6 | Fixed 000000 |
39 | Action Code | M |
| n | 3 | Fixed 000 |
41 | Card acceptor terminal identification | M |
| ans | 8 |
|
42 | Card acceptor identification code | M |
| ans | 15 |
|
43 | Card acceptor name / location | M |
| ans | ..999 |
|
48 | Message control data elements | M | LLL | ans | ..999 |
|
48-0 | Bit map | M |
| b | 8 |
|
48-4 | Batch/sequence number | M |
| n | 10 | Assigned by third party host |
48-8 | Customer data | C | LLL | ans | ..250 |
|
48-9 | Track II of vehicle card | O |
| ns | ..37 |
|
48-32 | VAT Percentages | M | LL | ans | ..91 |
|
48-37 | Vehicle identification entry mode | O |
| ans | 1 |
|
48-38 | Pump linked indicator | O |
| n | 1 |
|
48-39 | Delivery note number | O |
| n | 10 | POS ticket number |
49 | Currency code, transaction | M |
| an | 3 |
|
53 | Security Related Control Information | M | LL | b | ..48 |
|
59 | Transport data | M | LLL | ans | ..999 | Ref.13.25 |
63 | Product data | M | LLL | ans | ..999 |
|
64 | MAC | M |
| b | 8 |
|
FINANCIAL TRANSACTION ADVICE RESPONSE 1230
The following fields listed below are supported in the response message. Fields not listed are not supported.
Element number | Data element name | Presence | Format | Type | Size | Usage notes |
3 | Processing Code | ME |
| n | 6 |
|
4 | Amount, transaction | ME |
| n | 12 |
|
7 | Date and time, transmission | M | MMDDh hmmss | n | 10 |
|
11 | Systems trace audit number | ME |
| n | 6 |
|
12 | Date and time, local transaction | ME | YYMMD Dhhmm ss | n | 12 |
|
32 | Acquiring institution identification code | ME | LL | n | ..11 |
|
38 | Approval code | ME |
| anp | 6 |
|
39 | Action code | M |
| n | 3 | Fixed 000: Approved |
41 | Card acceptor terminal identification | ME |
| ans | 8 |
|
42 | Card acceptor identification code | ME |
| ans | 15 |
|
48 | Message control data elements | M | LLL | ans | ..999 |
|
48-0 | Bit map | M |
| b | 8 |
|
48-4 | Batch/sequence number | ME |
| n | 10 |
|
49 | Currency code, transaction | ME |
| an | 3 |
|
53 | Security Related Control Information | M | LL | b | ..48 |
|
59 | Transport Data | ME | LLL | ans | ..999 | Ref.13.25 |
64 | MAC | M |
| b | 8 |
|
Note: For technical reasons an advice can be declined. In this case the third party host need to retry the advice until manual intervention or the advice has been accepted.