Transaction Status Webhook
Transaction Status Webhook
SUCCESS, FAILED, CANCELLED, or RETURNED).🔐 Security & Reliability Requirements: Your endpoint must validate the webhook signature (provided in request headers) to ensure authenticity. Your system must be idempotent — GeoSwift may retry delivery on failure. Respond with HTTP 200 OK and a valid acknowledgment payload within 5 seconds.
Webhook Payload Example
{
"transactionReference": "GS26030218000000123",
"partnerTransactionReference": "GSWIFT_UK_NG_260302175959",
"errorCode": "0000",
"errorMessage": "Payout completed successfully",
"status": "SUCCESS"
}Request Parameters
| Parameter | Description | Data Type | Requirement |
|---|---|---|---|
transactionReference | Unique transaction identifier generated by GeoSwift. | String | Mandatory |
partnerTransactionReference | Unique reference provided by the sending partner during transaction creation. | String | Mandatory |
errorCode | Standardized code indicating the transaction outcome (0000 = success; non-zero = failure). | String | Mandatory |
errorMessage | Human-readable description of the transaction result. | String | Mandatory |
status | Final status of the transaction. Possible values: - SUCCESS: Payout completed. DO NOT REFUND SENDER- FAILED: Transaction failed. REFUND SENDER- CANCELLED: Cancelled by sender or partner. REFUND SENDER- RETURNED: Funds reversed by payout network. REFUND SENDER | String | Mandatory |
Response Parameters
| Parameter | Description | Data Type | Requirement |
|---|---|---|---|
acknowledged | Confirms successful receipt and processing of the webhook notification. Must be a boolean (true or false). | Boolean | Mandatory |
💡 Note: Your system must respond with HTTP 200 OKand a JSON body:{ "acknowledged": true }Do not return string values like "true"— use a proper boolean.
Modified at 2026-06-05 08:35:01