Transaction Update Event

This endpoint specifies what will be sent to your Transaction Webhook. Zeal POSTs a request containing a Transaction Object when it is is updated, namely a status change or new Transaction Event. You can update and test the webhook URL you want Zeal to hit on the ‘API’ Page of the Zeal Dashboard.

Returns

Doesn’t return anything but rather POSTs a request with a Transaction Object.

Raw Content Example

Settled Transaction

{
  "test": false,
  "transactionID": "a64f2bd0d7984ec9a999ff6ca92c567b",
  "amount": 1018.05,
  "status": "settled",
  "method": "next_day_ach",
  "source_instrument": {
    "bankAccountID": null,
    "last_four": null,
    "paycardID": null,
    "card_details": null,
    "wire_details": null
  },
  "destination_instrument": {
    "bankAccountID": "8b2a1073519a42f29ede3c29de573d16",
    "last_four": "0089",
    "paycardID": null,
    "card_details": null
  },
  "transaction_type": "net_pay_credit",
  "connection_type": "employee_check",
  "connectionID": "d010afab12674659ac89705920c8a06d",
  "traceID": null,
  "retry": false,
  "transaction_events": [
    {
      "transactionEventID": "f3b2a1c7e9d84b6a8c5f1d2e7a9b3c4d",
      "timestamp": "2026-04-14T19:30:56.705Z",
      "status": "processing",
      "return_code": null,
      "status_detail": null
    },
    {
      "transactionEventID": "c8a4e1d7b2f93a6c5e1b7d9a3f2c4e8a",
      "timestamp": "2026-04-14T19:30:57.205Z",
      "status": "settled",
      "return_code": null,
      "status_detail": null
    }
  ]
}

Returned transaction

{
  "test": false,
  "transactionID": "4c9e1a7b2d6f8c3a5e1b9d7f2c6a8e4d",
  "amount": 1162.38,
  "status": "returned",
  "method": "next_day_ach",
  "source_instrument": {
    "bankAccountID": "6f2a9c4e1b7d3a8f5c2e9b1d4a7c3f8e",
    "last_four": "4321",
    "paycardID": null,
    "card_details": null,
    "wire_details": null
  },
  "destination_instrument": {
    "bankAccountID": "1e7b3c9f4a2d8e6c5b1f9a3d7c4e2b8a",
    "last_four": "6789",
    "paycardID": null,
    "card_details": null
  },
  "transaction_type": "net_pay_credit",
  "connection_type": "employee_check",
  "connectionID": "9a3d7f1c4e8b2a6c5d1f9b3e7a2c4f6e",
  "traceID": null,
  "retry": false,
  "transaction_events": [
    {
      "transactionEventID": "2d8f4a1c7e3b9c6a5f1d7e2b4c8a3f9e",
      "timestamp": "2024-10-08T19:38:08.599Z",
      "status": "processing",
      "return_code": null,
      "status_detail": null
    },
    {
      "transactionEventID": "5e1a7c3d9f4b2a8e6c1d3f7b9a2c4e8f",
      "timestamp": "2024-10-09T12:00:00.000Z",
      "status": "settled",
      "return_code": null,
      "status_detail": null
    },
    {
      "transactionEventID": "8c3f1a6d4e9b2c7a5f1d8b3e6a2c4f7d",
      "timestamp": "2024-10-10T22:38:08.599Z",
      "status": "returned",
      "return_code": "R03",
      "status_detail": "closed_bank_account"
    }
  ]
}

Introduction

Webhooks

Zeal Components

Companies

Company Onboarding

Reserve Accounts

Customer Accounts (Early Access)

Taxable Locations

Work Locations

Employees

Employee Deduction Templates

Garnishments

Employee Onboarding

Bank Accounts

Custom Attributes

Paperwork API

Employee Checks

Contractors

Contractor Onboarding

Contractor Payment Deductions

Payment Items

Contractor Payments

Paycards

Instant Pay

Employer Checks

Preview

Embedded HR

Reports

Documents

Transaction Update Event

Returns

Raw Content Example

​Returns

​Raw Content Example

Returns

Raw Content Example