FINANCIAL TRANSACTION ADVICE 1220/1221/1230
For technical reasons an advice can be declined if PayEx is unable to store the transaction. In this case the third party host need to retry the advice until manual intervention or the advice has been accepted. It’s expected that the third party implement a retry delay with exponential wait period. After 6 retry attempts have failed manual intervention by third party and PayEx support must be initiated.
FINANCIAL TRANSACTION ADVICE 1220/1221
Element number | Data element name | Presence | Format | Type | Size | Usage notes |
3 | Processing Code | M | n | 6 | Fixed 000000. Other processing code values are currently not supported. | |
4 | Amount, transaction | M | n | 12 | E.g.: 1 kr (NOK) ="000000000100". | |
7 | Date and time, transmission | M | MMDDhhmmss | n | 10 | E.g.: 1025123020 |
11 | Systems trace audit number | M | n | 6 | Assigned by third party host | |
12 | Date and time, local transaction | M | YYMMDDhhmmss | n | 12 | E.g.: 171025100515 |
22 | Point of service data code | M | an | 12 | See table here for details. | |
24 | Function code | M | n | 3 | 200: Standing in for Card Issuer 201: Previously approved authorisation 202: Previously approved authorization (amount differs) | |
25 | Message reason code | M | n | 4 | 1003: Card Issuer unavailable 1004:Terminal processed | |
26 | Card acceptor business code | M | n | 4 | 5541 for indoor and 5542 for outdoor | |
33 | Forwarding Institution identification code | O | LL | n | ..11 | Unique id provided by PayEx used for all transactions from given 3rd party |
38 | Approval code | M | anp | 6 | Copied from original approved authorisation response if available. Otherwise 000000 | |
39 | Action code | M | n | 3 | Copied from approved authorisation, or 000 when approved offline. | |
41 | Card acceptor terminal identification | M | n | 8 | Needs to be unique per POS terminal at the merchant site. | |
42 | Card acceptor identification code | M | n | 15 | 8 digit unique ID provided by PayEx for each merchant. | |
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 | As specified here. |
48-9 | Track II of vehicle card | O | LL | ns | ..37 | Used to specify the second card in a transaction if a special card is needed in addition to the payment card to link a transaction to a loyalty account. |
48-38 | Pump linked indicator | O | n | 1 | Indicates whether the fuel pump reading is linked to the payment terminal: 2 - Pump not linked | |
48-39 | Delivery note number | O | n | 10 | Number allocated by the terminal given to the customer. (POS ticket number). Unique number pr transaction. | |
49 | Currency code, transaction | M | an | 3 | Numeric currency code (ISO-4217 standard). E.g. "578" for NOK | |
53 | Security Related Control Information | M | LL | b | ..48 | See security documentation section for details. |
56 | Original Data Elements | C | LL | n | ..35 | Not present if stand-in authorized (P-24 with value 200). Contains Message Type Indicator (MTI), STAN and Transaction Date and Time from original message. E.g. Length 22 "1200 023576 171031174233 " MTI is 4 digits, STAN (P-11) is 6 digits and Original transaction date/time(P-12) is in format "YYMMDDhhmmss". |
63 | Product data | M | LLL | ans | ..999 | See description below for details on how to create this field. |
127 | Encrypted track2 data | M | LLL | b | ..999 | See security documentation section for details. |
128 | MAC | M | b | 8 | See security documentation section for details. |
FINANCIAL TRANSACTION ADVICE RESPONSE 1230
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 | |
33 | Forwarding Institution identification code | ME | LL | n | ..11 | Unique id provided by PayEx used for all transactions from given 3rd party |
38 | Approval code | CE | anp | 6 | ||
39 | Action code | M | n | 3 | Action code. See action code section for available codes. | |
41 | Card acceptor terminal identification | ME | n | 8 | ||
42 | Card acceptor identification code | ME | n | 15 | ||
48 | Message control data elements | ME | LLL | ans | ..999 | |
48-0 | Bit map | ME | b | 8 | ||
48-4 | Batch/sequence number | ME | n | 10 | ||
49 | Currency code, transaction | ME | an | 3 | ||
53 | Security Related Control Information | ME | LL | b | ..48 | |
64 | MAC | M | b | 8 |