Creating Transactions

Single Transaction

To add a single ACH transaction to the system, use the following endpoint:

POST /api/v3/AchTransactions/companycode/{companyCode}

Example Flow

Collect Bank Account Info - In most cases, you’ll already have the customer’s banking info.
Create ACH Transaction - Schema can be found on Swagger UI.
```
POST /api/v3/AchTransactions/companycode/{companyCode}
```
Receive Response - The response will include the transaction ID and status.

Single Model

Model required for creating the transaction (filled with random example values):

Model Example:

{
  "firstSignerFirstName": "firstName",
  "firstSignerLastName": "lastName",
  "address1": "string",
  "address2": "string",
  "city": "3845470 0L{.&41{4772``}p,?75?2",
  "state": "Vn",
  "zip": "reTZ8nSa",
  "countryCode": "ro",
  "yourReferenceNumber": "string",
  "bankRoutingNumber": "271-09",
  "bankAccountNumber": "709-1",
  "amount": 0,
  "achTransactionCode": 0,
  "achAccountType": "PersonalChecking",
  "achTransactionType": "Debit",
  "achTransactionSubType": " ",
  "achEntryClass": "IAT",
  "achPaymentTypeCode": "st",
  "achCheckNumber": 0,
  "achIdentificationNumber": "string",
  "achCompanyEntryDescription": "string",
  "achCompanyDiscretionaryData": "string",
  "achTransactionDiscretionaryData": "st",
  "achAddendaText": "string",
  "sameDayAchRequested": true,
  "sendDate": "2025-06-11T18:25:21.435Z",
  "achEffectiveDate": "2025-06-11T18:25:21.435Z",
  "iatAddenda": {
    "transactionTypeCode": "",
    "foreignBeneficiaryPayer": {
      "name": "&-?`-L55-8{&10.9-1004L5{`662`8",
      "streetAddress": "98234/L``0? `56.-",
      "city": "0,'8{14''2p,{?ppp6{-1,p- ,}'&29`92",
      "stateCode": "YE",
      "postalCode": "vEci4",
      "countryCode": "Qv"
    }
  }
}

Bulk Transaction

To add many ACH transactions to the system, use the following endpoint:

POST /api/v3/AchTransactions/companycode/{companyCode}/many

Example Flow

Collect Bank Account Info - In most cases, you’ll already have the customer’s banking info.

Create ACH Transaction - Schema can be found on Swagger UI.

POST /api/v3/AchTransactions/companycode/{companyCode}/many

Receive Response - The response will include the transaction ID and status.

Bulk Model

Model required for creating the transaction (filled with random example values):

Model Example:

{
  "alwaysCommitValid": true,
  "items": [
    {
      "firstSignerFirstName": "`}1 ?3L@1",
      "firstSignerLastName": "9 6'}5 ?&",
      "address1": "string",
      "address2": "string",
      "city": "'58-L,p2}0L?,8p`p9}L-560``L937",
      "state": "zO",
      "zip": "CV",
      "countryCode": "XQ",
      "yourReferenceNumber": "string",
      "bankRoutingNumber": "511804537",
      "bankAccountNumber": "51991127",
      "amount": 0,
      "achTransactionCode": 0,
      "achAccountType": "PersonalChecking",
      "achTransactionType": "Credit",
      "achTransactionSubType": "Prenote",
      "achEntryClass": "",
      "achPaymentTypeCode": "S",
      "achCheckNumber": 0,
      "achIdentificationNumber": "string",
      "achCompanyEntryDescription": "string",
      "achCompanyDiscretionaryData": "string",
      "achTransactionDiscretionaryData": "st",
      "achAddendaText": "string",
      "sameDayAchRequested": true,
      "sendDate": "2025-06-11T19:03:28.262Z",
      "achEffectiveDate": "2025-06-11T19:03:28.262Z",
      "iatAddenda": {
        "transactionTypeCode": "",
        "foreignBeneficiaryPayer": {
          "name": "1&{5.3}-{?&91?1.0636 p{6949,7",
          "streetAddress": " /p",
          "city": "p40'7.0'&p1p ,3'.,4-.p6'919{}",
          "stateCode": "pb",
          "postalCode": "E4zN0",
          "countryCode": "oW"
        }
      }
    }
  ]
}