Checking an ACH Transaction Status

Clearent provides an ACH transaction status after every two hours, including PENDING or SETTLING statuses.

For example, when you receive the response for an ACH transaction, including a transaction ID d4a07b56-aa70-4f51-bac8-88bffb6b7de9 and other transaction details.

{
    "code": "200",
    "status": "success",
    "exchange-id": "ID-clearent-ach-transaction-2-7b71513a-535e-4918-89b9-8ea72ee636c3",
    "links": [
        {
            "rel": "self",
            "href": "https://gateway-sb.clearent.net/rest/v2/ach/transactions/d4a07b56-aa70-4f51-bac8-88bffb6b7de9",
            "id": "d4a07b56-aa70-4f51-bac8-88bffb6b7de9"
        },
        {
            "rel": "token",
            "href": "https://gateway-sb.clearent.net/rest/v2/ach/tokens/ach_1100000000041201",
            "id": "ach_1100000000041201"
        }
    ],
    "payload": {
        "ach-transaction": {
            "type": "Debit",
            "amount": "19.99",
            "status": "PENDING",
            "routing-number": "490000018",
            "account-number": "XXXXXX7890",
            "account-type": "CHECKING",
            "standard-entry-class-code": "WEB",
            "check-number": "1001",
            "individual-name": "Buffy Summers",
            "id": "d4a07b56-aa70-4f51-bac8-88bffb6b7de9",
            "invoice": "a04d9ff5-830c-4d43-8622-83f8681c3656",
            "purchase-order": "1731016624",
            "customer-id": "customer-id_c4145539-1cbc-4bcb-bd75-33ad6527d0d3",
            "order-id": "order-id-cd669947-e3ac-459d-85a0-42ffad34f63f",
            "email-address": "[e-mail]",
            "description": "a big boat",
            "comments": "these are comments",
            "display-message": "Transaction submitted",
            "provider-transaction-id": "d4a07b56-aa70-4f51-bac8-88bffb6b7de9",
            "ach-token": {
                "token-id": "ach_1100000000041201",
                "times-used": 10,
                "last-used": "2024-11-07T21:57:04.355175",
                "merchant-id": "000000502914",
                "routing-number": "490000018",
                "account-number": "7890",
                "account-type": "checking",
                "individual-name": "James Dude",
                "token-description": "cus_JdW0ZauDFfHkfi",
                "created": "2022-05-17T21:17:44.501638",
                "updated": "2024-11-07T21:57:04.357962"
            },
            "merchant-id": "000000502914",
            "terminal-id": "22122221",
            "software-type": "Postman",
            "paya-authorization": "272-172"
        },
        "payloadType": "ach-transaction"
    }
}

To check the status for this ACH transaction:

1. Use the GET method for the https://gateway.clearent.net/rest/v2/ach/transactions?id=d4a07b56-aa70-4f51-bac8-88bffb6b7de9 endpoint, passing the transaction ID as a URL parameter.

You will receive the response for a transaction ID d4a07b56-aa70-4f51-bac8-88bffb6b7de9 with the current transaction status.

{
    "code": "200",
    "status": "success",
    "exchange-id": "ID-clearent-ach-transaction-2-f53f6340-983d-45c7-a701-01d95856d1e8",
    "links": [
        {
            "rel": "self",
            "href": "https://gateway-sb.clearent.net/rest/v2/ach/transactions?id=d4a07b56-aa70-4f51-bac8-88bffb6b7de9"
        }
    ],
    "payload": {
        "ach-transactions": {
            "ach-transaction": [
                {
                    "type": "Debit",
                    "amount": "19.99",
                    "status": "SETTLED",
                    "routing-number": "490000018",
                    "account-number": "7890",
                    "account-type": "CHECKING",
                    "standard-entry-class-code": "WEB",
                    "check-number": "1001",
                    "individual-name": "Buffy Summers",
                    "id": "d4a07b56-aa70-4f51-bac8-88bffb6b7de9",
                    "billing": {},
                    "shipping": {},
                    "invoice": "a04d9ff5-830c-4d43-8622-83f8681c3656",
                    "purchase-order": "1731016624",
                    "customer-id": "customer-id_c4145539-1cbc-4bcb-bd75-33ad6527d0d3",
                    "order-id": "order-id-cd669947-e3ac-459d-85a0-42ffad34f63f",
                    "email-address": "[e-mail]",
                    "description": "a big boat",
                    "comments": "these are comments",
                    "billing-is-shipping": "false",
                    "status-change-date": "2024-11-07T21:57:04Z",
                    "provider-transaction-id": "d4a07b56-aa70-4f51-bac8-88bffb6b7de9",
                    "ach-token": {
                        "token-id": "ach_1100000000041201"
                    },
                    "merchant-id": "000000502914",
                    "software-type": "Postman",
                    "paya-authorization": "272-172"
                }
            ]
        },
        "payloadType": "ach-transactions"
    },
    "page": {
        "number": 1,
        "size": 25,
        "sort": {
            "field": {
                "createDateTimeUtc": "DESC"
            }
        },
        "first": true,
        "last": true,
        "total-pages": 1,
        "number-of-elements": 1,
        "total-elements": 1
    }
}

Similarly, you can search for various ACH transactions using the following ways:

• Search by status (including paging options)

https://gateway.clearent.net/rest/v2/ach/transactions?status=settled&pagesize=50&page=10

• Search by order ID (if provided with original transaction)

https://gateway.clearent.net/rest/v2/ach/transactions?orderid=order-id-cd669947-e3ac-459d-85a0-42ffad34f63f

• Search by customer ID (if provided with original transaction)

https://gateway.clearent.net/rest/v2/ach/transactions?customer-id=customer-id_c4145539-1cbc-4bcb-bd75-33ad6527d0d3

• Search by invoice (if provided with original transaction)

https://gateway.clearent.net/rest/v2/ach/transactions?invoice=a04d9ff5-830c-4d43-8622-83f8681c3656

• Search with no parameters.

https://gateway.clearent.net/rest/v2/ach/transactions