Network Totals Webhook Events

Release Date

July 3, 2025

Products Affected

Settlement API

Impact

Webhooks for network totals, and addition of completeness indicator

Audience

Customers managing their own network settlement

Action Required

Optionally subscribe to new webhook event types

Overview

We are introducing new event webhooks with types network_total.created and network_total.updated that provide real-time notification when a network total record is created or updated, respectively. These webhooks complement the network total endpoints in our Settlement API.

Additionally, we are enriching the network total record with an is_complete boolean field that indicates whether all associated settlement details are available in the List Settlement Details endpoint. A network_total.updated webhook fires when the network total transitions from incomplete to complete, i.e. is_complete toggles from false to true.

Details

The webhook payload contains the network total object as returned by the Get Network Total endpoint, with an additional field event_type that is either network_total.created or network_total.updated. Example below:

{
  "event_type": "network_total.created",
  "token": "12cf7505-06a8-435e-b1c7-4c430d02f6c3",
  "network": "VISA",
  "institution_id": "1000000000",
  "settlement_institution_id": "1000000001",
  "settlement_service": "015",
  "report_date": "2025-02-25",
  "currency": "CAD",
  "amounts": {
    "gross_settlement": 100,
    "interchange_fees": -25,
    "visa_charges": 10,
    "net_settlement": 85
  },
  "is_complete": false,
  "created": "2025-02-25T13:07:31.419631Z",
  "updated": "2025-02-25T13:07:31.419631Z"
}

For webhook configuration instructions, see our Events API documentation.

If you have any questions, contact us via the HELP link in your Lithic Dashboard.

The Lithic changelog has an RSS feed! To monitor for new update announcements, subscribe with your preferred RSS reader.