Fields for an ACH Service Credit Request {#batch-ref-fields-echeck-credits} =========================================================================== This table describes the required and optional fields for specifying an ACH service credit request. Field names are listed in the table as they appear in batch file templates. An asterisk after a field name indicates that the field is required for an authorization request. When you create a batch file based on a template, remove any asterisks from field names. | Column | Field Name | Description | Required? | Data Type | Length | |--------|-----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------|-----------|--------| | A | merchantReferenceCode\* | Merchant-generated order reference or tracking number. | Required | String | 50 | | B | purchaseTotals_currency\* | Currency used for the order. | Required | String | 5 | | 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 | 15 | | D | billTo_firstName\* | Customer's first name. The value should be the same as the one that appears on the card. | Required | String | 60 | | E | billTo_lastName\* | Customer's last name. The value should be the same as the one that appears on the card. | Required | String | 60 | | F | billTo_email\* | Customer's email address, including the full domain name. For example: jdoe@example.com | Required | String | 255 | | G | billTo_street1\* | First line of the billing street address. | Required | String | 60 | | H | billTo_street2 | Second line of the billing street address. Used for additional address information. For example: Attention: Accounts Payable | Required | String | 60 | | I | billTo_city\* | City of the billing address. | Required | String | 50 | | J | billTo_state\* | State or province of the billing address. Use the two-character codes. | Required | String | 2 | | K | billTo_country\* | Country of the billing address. Use the two-character ISO codes. | Required | String | 2 | | 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 | 10 | | M | check_accountType\* | Checking account type. See Request Fields for possible values. | Required | NA | NA | | N | check_bankTransitNumber\* | Bank routing number (or "transit number"). | Required | NA | NA | | O | check_accountNumber\* | Checking account number. If processing encoded account numbers, use this field for the encoded account number. | Required | NA | 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 | NA | | Q | billTo_phoneNumber | Customer's phone number. | Optional | String | 15 | | 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 | 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 | 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 | NA | | U | billTo_companyTaxID | Tax identifier of the customer's company. For `TeleCheck`, see description of billTo_company. | Optional | NA | 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 | NA | | W | ecCreditService_debitRequestToken | The requestToken returned from a previous request for ecDebitService. | Optional | NA | 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 | 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 | 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 | NA | [Fields in a Data Record for an ACH Service Credit Request]