After a payment is processed, the initial status simply confirms that the payment request has been initiated. Credit card transactions may take some time to fully process. To track the final status—whether the payment succeeds or fails—it is essential to register a webhook URL (contact the Sawfish team to configure this) where Sawfish can send status updates to your system.
Sample of webhook URL: https://your_domain/webhook/payments
When the webhook is triggered, Sawfish will send a response containing the payment payload along with HTTP headers that include the webhook signing key and client ID. These headers are critical for security. We strongly recommend validating all incoming webhook requests by verifying the header values against your stored keys before processing the data.
Payload:
{
"amount": 100,
"payment_gateway_fee": 1.75,
"paid_at": "2025-09-17T08:35:00Z",
"status": "completed",
"uuid": "payment-uuid-1234"
}