Fields for an ACH Service Debit Request

A

merchantReferenceCode

*

Merchant-generated order reference or tracking number.

Required

String

B

purchaseTotals_currency*

Currency used for the order.

Required

String

C

purchaseTotals_grandTotalAmount*

Grand total for the order. You must include either this field or

item_#_unitPrice

in your request. If you use

TSYS Acquiring Solutions

as your payment processor, you can set this field to 0 to check whether the card is lost or stolen.

Required

String

D

billTo_firstName*

Customer’s first name. The value should be the same as the one that appears on the card.

Required

String

E

billTo_lastName*

Customer’s last name. The value should be the same as the one that appears on the card.

Required

String

F

billTo_customerID

Your identifier for the customer.

Optional

String

G

billTo_email*

Customer’s email address, including the full domain name. For example: jdoe@example.com

Required

String

H

billTo_street1*

First line of the billing street address.

Required

String

I

billTo_street2

Second line of the billing street address. Used for additional address information. For example: Attention: Accounts Payable

Required

String

J

billTo_city*

City of the billing address.

Required

String

K

billTo_state*

State or province of the billing address. Use the two-character codes.

Required

String

L

billTo_country*

Country of the billing address. Use the two-character ISO codes.

Required

String

M

billTo_postalCode*

Postal code for the billing address. The postal code must consist of 5 to 9 digits. For a 9-digit postal code, use this format:

[5 digits][dash][4 digits]

If the value of billTo_country is CA, the postal code must follow these rules:

If the number of characters is greater than 3, the first 3 characters must be in this format: [alpha][numeric][alpha].
If the number of characters is 7, the last 3 characters must be in this format: [numeric][alpha][numeric].

Required

String

N

check_accountType*

Checking account type. See Request Fields for possible values.

Required

NA

O

check_bankTransitNumber*

Bank routing number (or "transit number").

Required

NA

P

check_accountNumber*

Checking account number. If processing encoded account numbers, use this field for the encoded account number.

Required

NA

Q

check_checkNumber

Check number. NOTE: If you use AmeriNet, check with them to see if they require you to provide this field.

Optional

NA

R

billTo_phoneNumber

Customer’s phone number.

Optional

String

S

billTo_driversLicenseNumber

Driver’s license number of the customer. Required for AmeriNet guaranteed personal checking. For

TeleCheck

, see description of billTo_company.

Optional

NA

T

billTo_driversLicenseState

State or province where the customer’s driver’s license was issued. Required for AmeriNet guaranteed personal checking. For

TeleCheck

, see description of billTo_company.

Optional

NA

U

billTo_company

Name of the customer’s company. Required for AmeriNet guaranteed corporate checking. For

TeleCheck

personal checks, you must provide billTo_driversLicenseNumber and billTo_driversLicenseState. For

TeleCheck

corporate checks, you must provide either both billTo_driversLicenseNumber and billTo_driversLicenseState, or both billTo_company and billTo_companyTaxID.

Optional

NA

V

billTo_companyTaxID

Tax identifier of the customer’s company. For

TeleCheck

, see description of billTo_company.

Optional

NA

W

billTo_dateOfBirth

Customer’s date of birth. NOTE: If you use AmeriNet, check with them to see if they require you to provide this field. For AmeriNet corporate accounts, use the value 1970-01-01.

Optional

NA

X

billTo_ipAddress

IP address for the customer. Example: 10.1.27.63.

Optional

String

Y

check_secCode

Code that specifies the authorization method for the transaction.

Optional

String