achNotificationsOfChange

A Notification of Change (NOC), notifies the sender of an ACH payment that information related to the customer’s bank account was inaccurate or outdated, and provides the updated information that needs to be corrected before another payment can be sent from (or to) the account.

Operation

query AchNotificationsOfChange($input: AchNotificationOfChangeInput!) {
  achNotificationsOfChange(input: $input) {
    items {
      acceptor {
        businessName
        id
        name
        reference
      }
      accountNumber
      accountNumberUpdated
      accountType
      accountTypeUpdated
      activityDate
      changeReason
      changeReasonCode
      id
      organization {
        achNotificationsOfChange
        businessName
        capabilities
        id
        legalName
        name
        phoneNumber
      }
      paymentId
      routingNumber
      routingNumberUpdated
      transactionActivityDate
      transactionAmount
      transactionCurrency
      transactionDateTime
      transactionId
      transactionReference
      transactionType
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
    }
  }
}

Response

{
  "data": {
    "achNotificationsOfChange": {
      "items": [
        {
          "acceptor": {
            "allocations": "example",
            "authorizationSummaries": "example",
            "billingDescriptor": "CLACKSWORTH KEYBOARDS",
            "businessName": "Clacksworth Keyboards",
            "fees": "example",
            "feeSummaries": "example",
            "fundingAchReturns": "example",
            "fundingDisputeEvents": "example",
            "fundingSummaries": "example",
            "fundingTransactions": "example",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Ben Torres",
            "paymentTransactions": "example",
            "paymentTransactionSummaries": "example",
            "reference": "example"
          },
          "accountNumber": "example",
          "accountNumberUpdated": "example",
          "accountType": "CHECKING",
          "accountTypeUpdated": "CHECKING",
          "activityDate": "2026-01-15",
          "changeReason": "example",
          "changeReasonCode": "C01",
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "organization": {
            "acceptorApplicationCounts": [
              "example"
            ],
            "acceptors": "example",
            "achNotificationsOfChange": "example",
            "achReturns": "example",
            "allocations": "example",
            "allowedMerchantCategories": [
              "example"
            ],
            "authorizationSummaries": "example",
            "businessAddress": "example",
            "businessName": "Clacksworth Keyboards",
            "capabilities": [
              "ACQUIRING"
            ],
            "fees": "example",
            "feeSummaries": "example",
            "fundingAchReturns": "example",
            "fundingDisbursementReturns": "example",
            "fundingDisputeEvents": "example",
            "fundingSummaries": "example",
            "fundingTransactions": "example",
            "id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
            "legalName": "example",
            "name": "Ben Torres",
            "paymentTransactions": "example",
            "paymentTransactionSummaries": "example",
            "phoneNumber": "example",
            "reportAvailability": [
              "example"
            ],
            "settings": "example"
          },
          "paymentId": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
          "routingNumber": "example",
          "routingNumberUpdated": "example",
          "transactionActivityDate": "2026-01-15",
          "transactionAmount": 0,
          "transactionCurrency": "example",
          "transactionDateTime": "2026-01-15T14:30:00Z",
          "transactionId": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
          "transactionReference": "example",
          "transactionType": "AUTHORIZATION"
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "hasPreviousPage": true
      }
    }
  }
}

Query

Arguments

input · AchNotificationOfChangeInput! · required

Show child attributes

paging · PagingInput! · required

See PagingInput

where · AchNotificationOfChangeFilterInput! · required

Show child attributes

activityDate · DateRangeFilterInput

See DateRangeFilterInput

paymentId · GuidFilterInput

See GuidFilterInput

Return type

AchNotificationOfChangeCollection

items · [AchNotificationOfChange!]! · required

Show child attributes

acceptor · Acceptor

See Acceptor

accountNumber · String! · required

The original bank account number.

accountNumberUpdated · String

The updated bank account number.

accountType · BankAccountType! · required

The type of bank account, either Checking or Savings, specified on the original transaction.

See BankAccountType

accountTypeUpdated · BankAccountType

The updated bank account type.

See BankAccountType

activityDate · Date! · required

The date the notification of change was received by Tesouro.

changeReason · String! · required

A reader friendly description of the Change reason code.

changeReasonCode · AchNotificationOfChangeCodes! · required

A unique code signaling that information in a prior ACH entry needs updating.

Show Possible enum values

C01 · enum

Incorrect bank account number

C02 · enum

Incorrect transit/routing number

C03 · enum

Incorrect transit/routing number and bank account number

C04 · enum

Bank account name change

C05 · enum

Incorrect payment code

C06 · enum

Incorrect bank account number and transit code

C07 · enum

Incorrect transit/routing number, bank account number and payment code

C08 · enum

Corrected foreign routing number

C09 · enum

Incorrect individual ID number

C10 · enum

Incorrect company name

C11 · enum

Incorrect company identification

C12 · enum

Incorrect company name and company ID

id · UUID! · required

A unique 36 character identifier created by Tesouro, and assigned to the specific change notification.

organization · Organization

See Organization

paymentId · UUID! · required

A unique 36 character identifier created by Tesouro and assigned to a group of transactions in the same payment request cohort. e.g., An authorization request, incremental authorization request, and the final capture would have the same paymentID.

routingNumber · String! · required

The original unique nine-digit number identifying the bank.

routingNumberUpdated · String

The updated routing number.

transactionActivityDate · Date! · required

The date Tesouro recognized the transaction that triggered the notification of change.

transactionAmount · Decimal! · required

The transaction amount submitted with the transaction request.

transactionCurrency · String! · required

The currency specified on the transaction request, in ISO 4217 alpha currency code format.

transactionDateTime · DateTime! · required

The date and time that Tesouro received the transaction request, in UTC. Formatted as 2024-03-27T02:40:00Z

transactionId · UUID! · required

The unique 36 character identifier Tesouro assigned to the transaction that triggered the notification of change.

transactionReference · String! · required

The unique identifier assigned to the transaction by the acceptor (or partner) and included in the original transaction request sent to Tesouro.

transactionType · TransactionType! · required

The type of transaction, either an ACH debit (sale) or ACH debit (refund).

See TransactionType

pageInfo · PageInfo! · required

Show child attributes

hasNextPage · Boolean! · required

hasPreviousPage · Boolean! · required

Operation

query AchNotificationsOfChange($input: AchNotificationOfChangeInput!) {
  achNotificationsOfChange(input: $input) {
    items {
      acceptor {
        businessName
        id
        name
        reference
      }
      accountNumber
      accountNumberUpdated
      accountType
      accountTypeUpdated
      activityDate
      changeReason
      changeReasonCode
      id
      organization {
        achNotificationsOfChange
        businessName
        capabilities
        id
        legalName
        name
        phoneNumber
      }
      paymentId
      routingNumber
      routingNumberUpdated
      transactionActivityDate
      transactionAmount
      transactionCurrency
      transactionDateTime
      transactionId
      transactionReference
      transactionType
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
    }
  }
}

Response

{
  "data": {
    "achNotificationsOfChange": {
      "items": [
        {
          "acceptor": {
            "allocations": "example",
            "authorizationSummaries": "example",
            "billingDescriptor": "CLACKSWORTH KEYBOARDS",
            "businessName": "Clacksworth Keyboards",
            "fees": "example",
            "feeSummaries": "example",
            "fundingAchReturns": "example",
            "fundingDisputeEvents": "example",
            "fundingSummaries": "example",
            "fundingTransactions": "example",
            "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "name": "Ben Torres",
            "paymentTransactions": "example",
            "paymentTransactionSummaries": "example",
            "reference": "example"
          },
          "accountNumber": "example",
          "accountNumberUpdated": "example",
          "accountType": "CHECKING",
          "accountTypeUpdated": "CHECKING",
          "activityDate": "2026-01-15",
          "changeReason": "example",
          "changeReasonCode": "C01",
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "organization": {
            "acceptorApplicationCounts": [
              "example"
            ],
            "acceptors": "example",
            "achNotificationsOfChange": "example",
            "achReturns": "example",
            "allocations": "example",
            "allowedMerchantCategories": [
              "example"
            ],
            "authorizationSummaries": "example",
            "businessAddress": "example",
            "businessName": "Clacksworth Keyboards",
            "capabilities": [
              "ACQUIRING"
            ],
            "fees": "example",
            "feeSummaries": "example",
            "fundingAchReturns": "example",
            "fundingDisbursementReturns": "example",
            "fundingDisputeEvents": "example",
            "fundingSummaries": "example",
            "fundingTransactions": "example",
            "id": "c9a1e2d3-4b5f-6789-0abc-def123456789",
            "legalName": "example",
            "name": "Ben Torres",
            "paymentTransactions": "example",
            "paymentTransactionSummaries": "example",
            "phoneNumber": "example",
            "reportAvailability": [
              "example"
            ],
            "settings": "example"
          },
          "paymentId": "d8b2f3e4-5c6a-7890-1bcd-ef2345678901",
          "routingNumber": "example",
          "routingNumberUpdated": "example",
          "transactionActivityDate": "2026-01-15",
          "transactionAmount": 0,
          "transactionCurrency": "example",
          "transactionDateTime": "2026-01-15T14:30:00Z",
          "transactionId": "e7c3a4b5-6d7e-8901-2cde-f34567890123",
          "transactionReference": "example",
          "transactionType": "AUTHORIZATION"
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "hasPreviousPage": true
      }
    }
  }
}