July 3, 2025

Network Totals Webhook Events
Release date: July 3, 2025
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
Products affected: Settlement API

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.