{
"clientCode": "demo_client",
"eventId": "6f1c2d4e-8a3b-4c5d-9e7f-0a1b2c3d4e5f",
"occurredAt": "2026-10-15T09:30:00.000Z",
"resource": {
"id": "REC_456",
"type": "receivable"
},
"revision": 2,
"type": "receivable.updated"
}Webhooks
Change notification
PayPathIQ sends this request to your configured endpoint when a Customer or Receivable change commits. It carries only the event identity, type, resource reference and revision: read the resource with your API key for detail. Verify the PayPathIQ-Signature header, which is t=<unix seconds>,v1=<hex HMAC-SHA256 of '<t>.<raw body>' keyed with your signing secret>; during the 24 hours after a rotation it carries a v1 value for each of the current and previous secrets. Reject timestamps more than 5 minutes old. Respond with any 2xx status within 5 seconds. Redirects are not followed. Any other outcome is retried with backoff up to 8 attempts over about two days, then abandoned: recover through the change feed. Delivery is at least once and unordered: discard repeated eventId values and compare revision before applying. Grants, scopes and the destination are re-checked on every attempt; a revoked grant or unsafe destination disables the endpoint.
WEBHOOK
changeNotification
{
"clientCode": "demo_client",
"eventId": "6f1c2d4e-8a3b-4c5d-9e7f-0a1b2c3d4e5f",
"occurredAt": "2026-10-15T09:30:00.000Z",
"resource": {
"id": "REC_456",
"type": "receivable"
},
"revision": 2,
"type": "receivable.updated"
}Authorizations
Integration-owned environment-specific API key. Never paste a production key into documentation tools.
Headers
Stable identity of the change; the same value as eventId.
t=,v1=[,v1=]
Body
application/json
The Client whose resource changed.
Pattern:
^[A-Za-z0-9_-]{1,128}$Stable identity of the change, identical to the eventId in the change feed. Discard repeats.
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$Show child attributes
Show child attributes
Accepted revision when the change committed. Notifications can arrive late or out of order: compare it with the revision you already hold.
Required range:
1 <= x <= 9007199254740991Available options:
customer.created, customer.updated, receivable.created, receivable.updated, payment_request.created, payment_request.updated, reconciliation.created, reconciliation.updated, receipt_delivery.created, receipt_delivery.updated, payment_delivery.created Response
2XX
Notification accepted. Any 2xx status.