Polling for NOCs

• ACH NOCs (Notice-of-Change): A notice of change (NOC) is a notification sent by the receiving financial institution to the originator of an ACH transaction, indicating that there has been a change in the account information or other details related to the transaction. This can include changes such as updated account numbers, new routing numbers, or changes in the account holder’s name. NOCs are important for maintaining accurate and up-to-date information in the ACH system, ensuring that future transactions are processed correctly and reducing the risk of errors or delays in payment processing.

Here is a little help with polling. We typically recommend polling a few times a day fetching. When an item is invalidated, returned, or blocked, the ReturnDate will match the Date the event occurred.

GET https://api-dev.flx-payments.com/api/AchTransactions/companycode/
<yourCompanyCode>?itemStatus=B&itemStatus=I&itemStatus=R&page=0&pageSize=200&returnDateStart=2025-05-19T00:00:00.000&returnDateEnd=2025-05-22T00:00:00.000

Note

• ItemStatus – Filter for items that are in the blocked, invalid, and returned status.
• Return Date – Use a date range that typically goes back 3 – 4 business days. Make sure you use “Return Date” and not “Send Date”.

Danger

A common mistake is filtering on the wrong date field. When an item is blocked, invalidated or returned, the Return Date is set to the day of that event.

Getting a Paged List of ACH NOC Items In System

To retrieve a paged list of ACH NOC (Notice-of-Change) items that are currently in the system, use the following endpoint:

GET /api/v3/AchNocs/companycode/{companyCode}

Export Document List of ACH NOC Items In System

To export a list of ACH NOC items currently in the system, use the following endpoint:

GET /api/v3/AchNocs/companycode/{companyCode}/export/filetype/{fileType}

Note

fileType can be ExcelOpenXml, or Json