Technical reference for the PAYMENT_SETTLED webhook event, including payload schema, field specifications, and implementation details.
Event Type: PAYMENT_SETTLED
Category: Settlement
Description: Settlement to merchant has been completed
This webhook is triggered when funds are successfully transferred to the merchant’s account.
Always "PAYMENT_SETTLED"
for this webhook event
Timestamp when the event occurred in YYYY-MM-DD HH:MM:SS format
Example: "2024-02-15 16:53:15"
Webhook payload version (currently “1.0”)
Unique identifier for the event instance
Example: "a3791670-7c5d-4a86-aa7a-fe35e58a9dbb"
Event-specific data payload containing settlement details
Always "PAYMENT_SETTLED"
for this webhook event
Timestamp when the event occurred in YYYY-MM-DD HH:MM:SS format
Example: "2024-02-15 16:53:15"
Webhook payload version (currently “1.0”)
Unique identifier for the event instance
Example: "a3791670-7c5d-4a86-aa7a-fe35e58a9dbb"
Event-specific data payload containing settlement details
Array of settlement objects containing the settlement information
Unique settlement identifier
Example: "ST8174378817"
UTR (Unique Transaction Reference) for the settlement
Example: "ST8174378817"
ISO 8601 timestamp when the settlement was completed
Example: "2025-06-20T19:22:54.734256Z"
Foreign exchange rate applied to the settlement
Example: 86
Final settlement amount transferred to the merchant
Example: 1952.8