Fields for an ACH Service Credit 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_email*

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

Required

String

G

billTo_street1*

First line of the billing street address.

Required

String

H

billTo_street2

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

Required

String

I

billTo_city*

City of the billing address.

Required

String

J

billTo_state*

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

Required

String

K

billTo_country*

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

Required

String

L

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

M

check_accountType*

Checking account type. See Request Fields for possible values.

Required

NA

N

check_bankTransitNumber*

Bank routing number (or "transit number").

Required

NA

O

check_accountNumber*

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

Required

NA

P

check_checkNumber

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

Optional

NA

Q

billTo_phoneNumber

Customer’s phone number.

Optional

String

R

billTo_driversLicenseNumber

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

TeleCheck

, see description of billTo_company.

Optional

NA

S

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

T

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

U

billTo_companyTaxID

Tax identifier of the customer’s company. For

TeleCheck

, see description of billTo_company.

Optional

NA

V

ecCreditService_debitRequestID

The requestID from the previous debit. See Follow-on or Stand-Alone Credit for more information.

Required for a

Cybersource

follow-on credit.

NA

W

ecCreditService_debitRequestToken

The requestToken returned from a previous request for ecDebitService.

Optional

NA

X

ecCreditService_partialPaymentID

Merchant-generated value that identifies a specific partial credit associated with an order. Make sure the field value you use for each credit request is unique within the scope of the order. Used only for

TeleCheck

. See Multiple Partial Credits.

Required for

TeleCheck

partial credits.

NA

Y

ecCreditService_referenceNumber

For

Cybersource

stand-alone credits with

TeleCheck

, set this field to the value that you received in the ecDebitReply_reconciliationID field in the associated debit’s reply. See Follow-on or Stand-Alone Credit for more information.

Required for

Cybersource

stand-alone credits with

TeleCheck

.

NA

Z

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