Payout Webhook#
When a payout reaches success, failure, or reversal, Setu sends a POST request with a JSON body. Use the fields on this Egypt page.Setu uses the webhookUrl from Initiate Payout when you sent one. Otherwise it uses the payout webhook URL in Merchant Dashboard → Settings.Verify Signature with Webhook Verification, then confirm the order with Fetch Payout Status before you update your records.Return HTTP 2xx. Setu treats the status code as acknowledgement and does not read the response body. A non-2xx response is sent again.| Header | Description |
|---|
| Content-Type | application/json |
| Signature | Standard Base64 of a signature made with Setu's private key |
| Timestamp | Unix time in seconds. It is part of the signature |
Body#
| Field | Description |
|---|
| transactionRef | Setu transaction reference. |
| merchantRef | Merchant reference for the transaction. |
| amount | Order amount. |
| fee | Processing fee. |
| status | Order status. |
| Value | Meaning |
|---|
| Success | Success |
| Failed | Failed |
| Reversal | Reversal |
Example#
{
"transactionRef": "e50f5496-1316-4fa6-a206-98be03550c4d",
"merchantRef": "19e5b36d-c9d6-4cb4-8e4e-e6fe0e3a0cb5",
"amount": "100",
"fee": "5.5",
"status": "Success"
}
Modified at 2026-10-08 20:03:40
