Main.POS.Payment Service provider API ISO8583_2 ( IFSF) H2H description - FINANCIAL TRANSACTION ADVICE 1220/1221/1230

Page of - last modified by Kristian Lingsom on 2017/10/13 16:14

FINANCIAL TRANSACTION ADVICE 1220/1221/1230

Kristian Lingsom

2017/10/13 16:14

Table of Contents

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: 0 - Unspecified 1 - Pump-linked 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