API Documentation

ACH Transaction File

A summary of ACH transactions which have posted for a given day. It is intended to be used in conjunction with the Posted Transaction File.

ACH Transaction File Definition

This file is created by CorePro on a daily basis. It has the following properties:

  1. Fixed-length. Header row is 129 bytes excluding line endings. Each content row is 347 bytes excluding line endings.
  2. ANSI encoded
  3. Line endings are Windows-style CarriageReturn + LineFeed (\r\n, or 0x0D0A)
  4. File will be available in the relative directory of /AchTransaction
  5. File name follows a specific, case-sensitive pattern of: yyyyMMddhhmm_ACHTRANSACTION.TXT
  6. Root-relative path on sftp.corepro.io for that file would be: /AchTransaction/202003110304_ACHTRANSACTION.TXT

Format Disclaimer
Q2 Open reserves the right to append new field(s) to the end of any Header or Content line without notice. This is to allow new data points to be added as needed in a timely fashion.

Implementation Note
Your code should be written such that unexpected characters after the "last" field but prior to the end of each line should be ignored. That is, if the file is documented as being 872 bytes per line, receiving a file with 984 bytes per line should not disrupt your processing. This applies to both Header and Content lines.

File Name Disclaimer
The date in file name should be used as a guideline for human eyes only. Any date-related programmatic dependencies should rely on the FileCreatedDate or FileEffectiveDate contained within the header line of each file, as these will be precise to the second and will be in the appropriate timezone.

Header Row

Property Data Type (Length) Alignment Start Position Description
RecordType string (1) Left 1 The flag for the header row. Will always be H.
FileName string (50) Left 2 The name of this request file excluding path. Will be named following this pattern:
  1. yyyyMMddhhmm_ACHTRANSACTION.TXT
  2. Example: 201410210215_ACHTRANSACTION.TXT
RecordCount integer (10) Right 52 The number of records represented within the file.
NOTE: This field is zero-padded on the left side. e.g.: 0000000872
FileCreatedDate datetime (34) Right 62 The date the file was created.
Follows same format as API e.g.: 2014-10-20T10:30:31.456-05:00. See date format details.
FileEffectiveDate datetime (34) Right 96 The date to which the data in the file pertains.
Follows same format as API e.g.: 2014-10-20T23:59:59.999-05:00. See date format details.

Content Row

Property Data Type (Length) Alignment Start Position Description
CustomerId integer (10) Right 1 The unique identifier for a Customer.
NOTE: This field is zero-padded on the left side. e.g.: 0000000872
CustomerTag string (50) Left 11 The client-supplied unique identifier for the customer, aka the tag property on the customer object. This may be empty as it is an optional property.
AccountId integer (10) Right 61 The unique identifier for the account from which funds will be withdrawn.
NOTE: This field is zero-padded on the left side. e.g.: 0008309285
This is NOT an accountNumber. It is the accountIdof an account or an externalAccountId of an externalAccount object.
AccountTag string (50) Left 71 The client-supplied unique identifier for the account, aka the tag property on the account object. This may be empty as it is an optional property.
AccountName string (50) Left 121 The name of the account or externalAccount.
TransactionId integer (19) Right 171 The unique identifier for the transaction.
NOTE: This field is zero-padded on the left side. e.g.: 0008309285
TransactionTag string (50) Left 190 The client-supplied unique identifier for the transaction. See transaction object definition for details.
TransactionTypeCode string (6) Left 240 The typeCode of the transaction object.
TraceNumber string (15) Left 246 The Trace Number of the Nacha file entry detail record, positions 80-94
StandardEntryClassCode string (3) Left 261 The Standard Entry Class Code of the Nacha file batch record, positions 51-53
CompanyName string (16) Left 264 The Company Name of the Nacha file batch record, positions 5-20
CompanyDiscretionaryData string (20) Left 280 The Company Discritionary Data of the Nacha file batch record, positions 21-40
CompanyEntryDescription string (10) Left 300 The Company Entry Description of the Nacha file batch record, positions 54-63
ReceivingCompanyName string (22) Left 310 The Receiving Company Name (Individual Name) of the Nacha file entry detail record, positions 55-76
IdentificationNumber string (15) Left 332 The Identification Number of the Nacha file entry detail record, positions 40-54

Example ACH Transaction File

Content: See 202003011500_ACHTRANSACTION.TXT
NOTE: Your browser or text editor may wrap the text to fit the window. Actual source file does not wrap.


Ready to start a conversation?

Email Us