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.

1220 Refund / Force / DCC Quote Rejection Request

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 the establishment requesting the transaction.

43

Card Acceptor Name / Address

Optional

Name and/or address of the 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

ISO numeric currency code of the transaction amount specified in Field 6.

Required if Field 6 is present.

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) determines the number of supported currencies. Elavon will advise the partner of the appropriate values in Tag 01.

63

Reserved Private Data III

Conditional

 

64

MAC

Conditional

Value calculated as described in Appendix B if MAC processing is supported.

 

1230 Refund / Force / DCC Quote Rejection Response

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 and 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.