Skip to main content

Request Fields

These fields should be sent in addition to the Basic Request Fields.

Field NameMandatory?Description
customerAddressYes[1]For AVS checking, this must be a registered billing address for the card.
customerPostCodeYes[2]For AVS checking, this must be a registered postcode for the card.
cardCVVYes[3]For CVV checking, this must be the Card Verification Value printed on the card.
avscv2CheckRequiredNo[4]

Is AVS/CV2 checking required for this transaction?

Possible values are:

N – Checking is not required.

Y – Abort if checking is not enabled.

cv2CheckPrefNo[4]

List of cv2Check response values that are to be accepted; any other value will cause the transaction to be declined. Refer to the AVS/CV2 Check Response Codes section for details.

Value is a comma separated list containing one or more of the following: not known, not checked, matched, not matched, partially matched.

addressCheckPrefNo[4]

List of addressCheck values that are to be accepted; any other value will cause the transaction to be declined. Refer to the AVS/CV2 Check Response Codes section for details.

Value is a comma separated list containing one or more of the following: not known, not checked, matched, not matched, partially matched.

postcodeCheckPrefNo[4]

List of postcodeCheck response values that are to be accepted; any other value will cause the transaction to be declined. Refer to the AVS/CV2 Check Response Codes section for details.

Value is a comma separated list containing one or more of the following: not known, not checked, matched, not matched, partially matched.

Footnotes

  1. Mandatory if AVS address checking is required.
  2. Mandatory if AVS postcode checking is required.
  3. Mandatory if CV2 checking is required.
  4. Overrides any Merchant Account setting configured via the Merchant Management System (MMS).