moov/ach-test-harness repository overview

docker pull moov/ach-test-harness:latest
docker run -p 2222:2222 -p 3333:3333 moov/ach-test-harness:latest

ACHTestHarness:
  Servers:
    FTP:
      RootPath: "./data"
      Hostname: "0.0.0.0"
      Port: 2222
      Auth:
        Username: "admin"
        Password: "secret"
      PassivePorts: "30000-30009"
      Paths:
        Files: "/outbound/"
        Return: "/returned/"
    Admin:
      Bind:
        Address: ":3333"
  Responses:
    # Entries that match both the DFIAccountNumber and TraceNumber will be returned with a R03 return code.
    - match:
        accountNumber: "12345678"
        traceNumber: "121042880000001"
      action:
        return:
          code: "R03"

# All populated fields must match for the action to be applied to the EntryDetail
match:
  # Match the DFIAccountNumber on the EntryDetail
  accountNumber: <string>
  amount:
    min: <integer>
    max: <integer>
    value: <integer>    # Either min AND max OR value is used
  debit: <object>       # Include this to only match on debits
  traceNumber: <string> # Exact match of TraceNumber

action:
  # Send the EntryDetail back with the following ACH change code
  correction:
    code: <string>
    data: <string>

  # Send the EntryDetail back with the following ACH return code
  return:
    code: <string>

  - match:
      debit: {} # remove if you want to return Credits and Debits
      amount:
        min: 100000 # $1,000
        min: 120000 # $1,200
    action:
      return:
        code: "R01"

  - match:
      # This matches ./examples/ppd-debit.ach
      traceNumber: "121042880000001"
    action:
      return:
        code: "R03"

  - match:
      # This matches ./examples/utility-bill.ach
      accountNumber: "744-5678-99"
    action:
      correction:
        code: "C01"
        data: "744567899"

  - match:
      routingNumber: "111222337"
    action:
      copy:
        path: "/reconciliation/"