Skip to content

Pre-authorization closure

Pre-authorization closure request message (from ECR)

Pos	Length	Type	Content
1	8	N	Terminal ID (00000000-99999999)
9	1	A	Reserved – fixed to ‘0’ (0x30)
10	1	A	Message code: ‘i’ (0x63)
11	8	N	Cash register ID
19	1	N	Presence of message with additional data for the GT: ‘0’ = additional data message not present ‘1’ = additional data message present
20	4	N	Reserved – fixed to ‘0’ (0x30)
24	8	N	Authorization transaction amount, right aligned, filled with ‘0’ (0x30) on the left. Amount is always considered to be expressed in cents (e.g. 650 = 6,50)
32	128	AN	Text to be print (Code contract) at the end of the payment receipt. The field is always 128 chars long, it’s right aligned, filled with ‘ ‘ (0x20) on the left. The terminal shall only print valid chars, skipping the blanks.
160	9	N	Unique identifier of the pre-authorization received from Host and printed on the pre-authorization receipt issued by the terminal (Original Preathorization Code)
169	8	N	Reserved – fixed to ‘0’ (0x30)

Pre-authorization closure response message without currency exchange data (from Terminal)

Pos	Length	Type	Content
1	8	N	Terminal ID (00000000-99999999)
9	1	A	Reserved – fixed to ‘0’ (0x30)
10	1	A	Message code: ‘c’ (0x63)
11	2	N	Transaction result: “00” = OK “01” = KO “09” = received unknown Tag from GT

If transaction result is positive (00)

Pos	Length	Type	Content
13	19	N	Card PAN, right aligned, filled with ‘0’ (0x30) on the left. The PAN is
32	3	A	Transaction type: “ICC” = ICC card “MAG” = magnetic stripe card “MAN” = manual PAN entry “CLM” = c-less magstripe “CLI” = c-less ICC
35	6	A	Authorization code received from host
41	7	A	Transaction date and time received from host in DDDHHMM. The day is expressed as number of days since 01/01 of current year. For example, July 29, 15:20 is sent as 2111520.

If transaction result is negative (01)

Pos	Length	Type	Content
13	24	A	Result description. This field shall report, using only ASCII characters, the reason of the denial. The field is left aligned, filled with blank on the right.
37	11	N	Reserved – fixed to ‘0’ (0x30)

Common to any response

Pos	Length	Type	Content
48	1	N	Card type: '1' = Bancomat card '2' = Credit card '3' = Other card
49	11	N	Acquirer ID. The field is left aligned, filled with blanks on the right.
60	6	N	STAN. Transaction sequence number.
66	6	N	ID online. Online operation progressive number.
72	3	N	Action Code relating to the current payment operation. The field, if present, applies either to the positive and negative transactions.

Pre-authorization closure response message with currency exchange data (from Terminal)

Pos	Length	Type	Content
1	8	N	Terminal ID (00000000-99999999)
9	1	A	Reserved – fixed to ‘0’ (0x30)
10	1	A	Message code: ‘v’ (0x76)
11	2	N	Transaction result: “00” = OK “01” = KO “09” = received unknown Tag from GT

If transaction result is positive (00)

Pos	Length	Type	Content
13	19	N	Card PAN, right aligned, filled with ‘0’ (0x30) on the left. The PAN is
32	3	A	Transaction type: “ICC” = ICC card “MAG” = magnetic stripe card “MAN” = manual PAN entry “CLM” = c-less magstripe “CLI” = c-less ICC
35	6	A	Authorization code received from host
41	7	A	Transaction date and time received from host in DDDHHMM. The day is expressed as number of days since 01/01 of current year. For example, July 29, 15:20 is sent as 2111520.

If transaction result is negative (01)

Pos	Length	Type	Content
13	24	A	Result description. This field shall report, using only ASCII characters, the reason of the denial. The field is left aligned, filled with blank on the right.
37	11	N	Reserved – fixed to ‘0’ (0x30)

Common to any response

Pos	Length	Type	Content
48	1	N	Card type: '1' = Bancomat card '2' = Credit card '3' = Other card
49	11	N	Acquirer ID. The field is left aligned, filled with blanks on the right.
60	6	N	STAN. Transaction sequence number.
66	6	N	ID online. Online operation progressive number.
72	3	N	Action Code relating to the current payment operation. The field, if present, applies either to the positive and negative transactions.
75	1	N	Currency exchange transaction flag. The value is set to ‘1’ only when the transaction has been performed with a currency different from terminal currency. Important: if this value is ‘0’, following fields are not meaningful.
76	8	N	Exchange rate, right aligned with 4 decimal digits. – Received by the host “DCC”.
84	3	A	Alphanumeric currency code of transaction currency, as received by the host.
87	12	N	Transaction amount in the transaction currency, right aligned with ‘0’ (0x30) filler on the left - Received by the host “DCC”.
99	1	N	Precision (number of decimals) of transaction currency.
100	10	N	Reserved – fixed to ‘0’ (0x30)

What was your feeling about it?