Skip to main content

General Transaction Event Webhook Response

Our webhooks keep you updated in real-time about important events related to transactions processed through our system. By using these webhooks, you can create applications that quickly respond to changes in transaction statuses.

The JSON body structure of a General Transaction Event webhook call that you will receive, is as follows:

curl -L 'https://example-url.com/ach-payments-api/v1/{your-webhook-url}' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic PHVzZXJuYW1lPjo8cGFzc3dvcmQ+' \
-d '{
"notificationId": "73a3ee45-8d56-4be6-9307-7456e92d0b75",
"eventType": "gen.trans.info",
"eventDateTime": "2025-09-02T17:24:50.000-06:00",
"data": {
"generalTransactionEventInfo": {
"accountId": "123456789",
"accountType": "D",
"amount": "10.00",
"type": "Cr",
"description": "Misc Credit",
"category": "",
"channel": null,
"classification": null,
"receiptId": "XXX1234567",
"exceptionInfo": []
}
}
}
URL

The your-webhook-url will be the full FDNS custom HTTP endpoint that provided during your onboarding.

The section below describes the parameters and objects present in the request.

Body Parameters

notificationIdstringrequired

Unique ID of the notification.

eventTypestringrequired

The type of event that triggered the notification.

eventDateTimestringrequired

Timestamp of when the event occurred.

dataobjectrequired
Show properties
generalTransactionEventInfoobjectrequired
Show properties
accountIdstringrequired

The ID of the account.

accountTypestring

Type of the account.

amountstring

The transaction amount.

typestring

The transaction type (e.g., Cr or Dr).

descriptionstring

Description of the transaction.

categorystring

Category of the transaction.

channelstring

The channel through which the transaction was initiated.

classificationstring

Classification of the transaction.

receiptIdstring

The transaction's unique receipt ID.

exceptionInfoarray
Show properties
[]object

Details about any exceptions related to the transaction.