1220 / 1230 Messages – Refunds / Force

A 1220 is sent in the following cases:

Transaction referred and voice authorisation issued resulting in an offline force transaction.
Refund and repeat messages.

If a 1230 is not sent in response to a 1220, a 1221 can be sent for a maximum of 3 attempts.

Note: The DCC quote rejection is a legacy transaction and should only be supported if agreed with a partner’s nominated Elavon implementation contact.

Field	Field Name	Required	Comments
	Message Type ID	Mandatory	1220 (or 1221 for repeat message).
	Primary Bitmap	Mandatory
2	PAN	Conditional	Present only if Field 35 (Track 2) is not provided. Keyed transactions only.
3	Processing Code	Mandatory	See Field 3 description for valid values.
4	Transaction Amount	Mandatory	The amount of the currency specified in Field 49.
6	Cardholder Billing Amount	Conditional	Included if DCC has been performed on the device. The amount of the currency specified in Field 51.
10	Conversion Rate	Conditional	Mandatory if Field 6 is present.
11	STAN	Mandatory	System Trace Audit Number.
12	Transaction Local Date and Time	Mandatory	Date and time at the device.
14	Expiration Date	Conditional	Present only if Field 35 (Track 2) is not provided. Keyed transactions only.
22	Point of Service Data	Mandatory	See Field 22 description for details.
24	Function Code	Mandatory	Values of 200 to 203.
25	Reason Code	Mandatory
28	Reconciliation Date	Mandatory
29	Reconciliation Number	Mandatory
32	Acquiring Institution ID	Mandatory	Provided by Elavon.
35	Track 2 Data	Conditional	This field shall be supplied if a magnetic stripe card is swiped through the POS reader or an ICC card is read through an ICC device reader. If this field is present, Fields 2 and 14 should not be provided.
37	Retrieval Reference Number	Mandatory	Unique partner transaction reference.
38	Approval Code	Conditional	This field is required in an offline force transaction.
41	Terminal Identification	Mandatory	Card Acceptor Terminal ID.
42	Merchant ID	Mandatory	A unique ID of establishment requesting the transaction.
43	Card Acceptor Name / Address	Optional	Name/Address of establishment requesting the transaction.
48	Additional Private Data	Mandatory
49	Transaction Currency Code	Mandatory	ISO numeric currency code of the amount in Field 4.
51	Cardholder Billing Currency Code	Conditional	Required if Field 6 is present. ISO numeric currency code of the transaction amount specified in Field 6.
55	Integrated Circuit Card Data	Conditional	Must be supplied when the ICC has been used to process the transaction.
60	Reserved Private Data	Mandatory	If a partner supports DCC, Tag 01 (bytes 3 – 4) determine the number of supported currencies. Elavon will advise the partner of the appropriate values in Tag 01.
63	Reserved Private Data III	Conditional	Refer to Field Descriptions for available Tags.
64	MAC	Conditional	Value calculated as described in Appendix B if MAC processing is supported.

Field	Field Name	Required	Comments
	Message Type ID	Mandatory	1230
	Primary Bitmap	Mandatory
2	PAN	Mandatory	Echo value in 1220/1221.
3	Processing Code	Mandatory	Echo value in 1220/1221.
4	Transaction Amount	Mandatory	The amount will be in the currency specified in Field 49.
6	Cardholder Billing Amount	Conditional	Echo value if present in corresponding 1220/1221.
10	Conversion Rate	Conditional	Echo value if present in corresponding 1220/1221.
11	STAN	Mandatory	Echo value in 1220/1221.
12	Transaction Local Date & Time	Mandatory	Echo value in 1220/1221.
28	Reconciliation Date	Mandatory	Echo value in 1220/1221.
29	Reconciliation Number	Mandatory	Echo value in 1220/1221.
32	Acquiring Institution ID	Mandatory	Echo value in 1220/1221.
37	Retrieval Reference Number	Mandatory	Echo value in 1220/1221.
38	Approval Code	Conditional	Echo value if present in corresponding 1220/1221.
39	Response Code	Mandatory
41	Terminal Identification	Mandatory	Echo value in 1220/1221.
42	Merchant ID	Mandatory	Echo value in 1220/1221.
43	Card Acceptor Name / Address	Conditional	Echo value if present in corresponding 1220/1221.
48	Additional Private Data	Mandatory
49	Transaction Currency Code	Mandatory	Echo value in 1220/1221.
51	Cardholder Billing Currency Code	Conditional	Echo value if present in corresponding 1220/1221.
55	Integrated Circuit Card Data	Conditional	Always returned for an ICC Transaction. Full details in Field 55 description.
63	Reserved Private Data III	Conditional	Only those tags relevant to response messages will be returned.
64	MAC	Conditional	Value calculated as described in Appendix B if MAC processing is supported.