1

Response Code

The overall status of the transaction

1 = Approved
2 = Declined
3 = Error
4 = Held for Review

2

Response Subcode

A code used by the payment gateway for internal transaction tracking

3

Response Reason Code

A code that provides more details about the result of the transaction

Numeric

See Response Code Details for a listing of response reason codes.

4

Response Reason Text

A brief description of the result, which corresponds with the response reason code

Text

You can generally use this text to display a transaction result or error to the customer. However, please review the Response Code Details topic to identify any specific texts you do not want to pass to the customer.

5

Authorization Code

The authorization or approval code

6 characters

6

AVS Response

The Address Verification Service (AVS) response code

A = Address (Street) matches, ZIP does not
B = Address information not provided for AVS check
E = AVS error
G = Non-U.S. Card Issuing Bank
N = No Match on Address (Street) or ZIP
P = AVS not applicable for this transaction
R = Retry — System unavailable or timed out
S = Service not supported by issuer
U = Address information is unavailable
W = Nine digit ZIP matches, Address (Street) does not
X = Address (Street) and nine digit ZIP match
Y = Address (Street) and five digit ZIP match
Z = Five digit ZIP matches, Address (Street) does not

Indicates the result of the AVS filter.

For more information about AVS, see the Merchant Integration Guide.

7

Transaction ID

The payment gateway assigned identification number for the transaction

When Test Mode is enabled on the payment gateway, this value will be 0.

This value must be used for any follow-on transactions such as a CREDIT, PRIOR_AUTH_CAPTURE or VOID.

8

Invoice Number

The merchant-assigned invoice number for the transaction

Up to 20 characters (no symbols)

9

Description

The transaction description

Up to 255 characters (no symbols)

10

Amount

The amount of the transaction

Up to 15 digits

11

Method

The payment method

CC or ECHECK

12

Transaction Type

The type of credit card transaction

AUTH_CAPTURE, AUTH_ONLY, CAPTURE_ONLY, CREDIT, PRIOR_AUTH_CAPTURE, VOID

13

Customer ID

The merchant assigned customer ID

Up to 20 characters (no symbols)

14

First Name

The first name associated with the customer’s billing address

Up to 50 characters (no symbols)

15

Last Name

The last name associated with the customer’s billing address

Up to 50 characters (no symbols)

16

Company

The company associated with the customer’s billing address

Up to 50 characters (no symbols)

17

Address

The customer’s billing address

Up to 60 characters (no symbols)

18

City

The city of the customer’s billing address

Up to 40 characters (no symbols)

19

State

The state of the customer’s billing address

Up to 40 characters (no symbols) or a valid two-character state code

20

ZIP Code

The ZIP code of the customer’s billing address

Up to 20 characters (no symbols)

21

Country

The country of the customer’s billing address

Up to 60 characters (no symbols)

22

Phone

The phone number associated with the customer’s billing address

Up to 25 digits (no letters). Example: (123)123-1234

23

Fax

The fax number associated with the customer’s billing address

Up to 25 digits (no letters) Example: (123)123-1234

24

Email Address

The customer’s valid email address

Up to 255 characters

25

Ship To First Name

The first name associated with the customer’s shipping address

Up to 50 characters (no symbols)

26

Ship To Last Name

The last name associated with the customer’s shipping address

Up to 50 characters (no symbols)

27

Ship To Company

The company associated with the customer’s shipping address

Up to 50 characters (no symbols)

28

Ship To Address

The customer’s shipping address

Up to 60 characters (no symbols)

29

Ship To City

The city of the customer’s shipping address

Up to 40 characters (no symbols)

30

Ship To State

The state of the customer’s shipping address

Up to 40 characters (no symbols) or a valid two-character state code

31

Ship To ZIP Code

The ZIP code of the customer’s shipping address

Up to 20 characters (no symbols)

32

Ship To Country

The country of the customer’s shipping address

Up to 60 characters (no symbols)

33

Tax

The tax amount charged

Numeric

Delimited tax information is not included in the transaction response.

34

Duty

The duty amount charged

Numeric

Delimited duty information is not included in the transaction response.

35

Freight

The freight amount charged

Numeric

Delimited freight information is not included in the transaction response.

36

Tax Exempt

The tax exempt status

TRUE, FALSE,
T, F,
YES, NO,
Y, N,
1, 0

37

Purchase Order Number

The merchant assigned purchase order number

Up to 25 characters (no symbols)

38

MD5 Hash

The payment gateway generated MD5 hash value that can be used to authenticate the transaction response.

Because transaction responses are returned using an SSL connection, this feature is not necessary for AIM.

39

Card Code Response

The card code verification (CCV) response code

M = Match
N = No Match
P = Not Processed
S = Should have been present
U = Issuer unable to process request

Indicates the result of the CCV filter.

For more information about CCV, see the Merchant Integration Guide.

40

Cardholder Authentication Verification Response

The cardholder authentication verification response code

Blank or not present = CAVV not validated
0 = CAVV not validated because erroneous data was submitted
1 = CAVV failed validation
2 = CAVV passed validation
3 = CAVV validation could not be performed; issuer attempt incomplete
4 = CAVV validation could not be performed; issuer system error
5 = Reserved for future use
6 = Reserved for future use
7 = CAVV attempt — failed validation — issuer available (U.S.-issued card/non-U.S acquirer)
8 = CAVV attempt — passed validation — issuer available (U.S.-issued card/non-U.S. acquirer)
9 = CAVV attempt — failed validation — issuer unavailable (U.S.-issued card/non-U.S. acquirer)
A = CAVV attempt — passed validation — issuer unavailable (U.S.-issued card/non-U.S. acquirer)
B = CAVV passed validation, information only, no liability shift

51

Account Number

Last 4 digits of the card provided

Alphanumeric (XXXX6835)

This field is returned with all transactions.

52

Card Type

Visa, MasterCard, American Express, Discover, Diners Club,  JCB

Text

53

Split Tender ID

The value that links the current authorization request to the original authorization request. This value is returned in the reply message from the original authorization request

Alphanumeric

This is only returned in the reply message for the first transaction that receives a partial authorization.

54

Requested Amount

Amount requested in the original authorization

Numeric

This is present if the current transaction is for a prepaid card or if a splitTenderId was sent in.

55

Balance On Card

Balance on the debit card or prepaid card

Numeric

This has a value only if the current transaction is for a prepaid card.