Webhooks

Tenants configure webhook endpoints in the portal for service events and async processing callbacks.

Webhook Products

Product Code	Service	Typical Events
investment_ipo	IPO	subscription submitted, completed, failed, CSCS/CHN reconciliation
proof_of_address_document_extract	AI Processing Hub	async extraction completed or failed
business_validation_cac	Business Validation CAC	future validation callbacks where needed

Signed Event Example

json

{
  "event": "investment.subscription.completed",
  "id": "evt_01J...",
  "tenantId": "11111111-1111-1111-1111-111111111111",
  "data": {
    "investorId": "ngx_inv_001",
    "ngxReference": "NGX-TXN-0001",
    "status": "completed"
  },
  "createdAt": "2026-07-27T09:00:00Z"
}

Signature

Webhook deliveries are signed with an HMAC signature header. Receivers should verify signatures, store event IDs idempotently, and return 2xx only after durable processing.