Payment Confirmation

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 webhook URL: https://{{your_domain}}/webhook/payments

When the webhook is triggered, Sawfish will send a request containing the payment payload along with HTTP headers that include the webhook signing key and client ID.

Caution

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

{
  "type": "payment_update",
  "uuid": "payment-uuid-1234",
  "payment_gateway_fee": 1.75,
  "paid_at": "2025-09-17T08:35:00Z",
  "status": "completed",
  "total_amount": 100,
  "reference": null,
  "transaction_id": "100014223834147",
  "payment_brand": "visa",
  "metadata": null,
  "description": "invoice-1234",
  "failed_reason": null,
  "created_at": "2025-09-17T08:30:00Z",
  "updated_at": "2025-09-17T08:35:00Z"
}

Timestamps (paid_at, created_at, updated_at) are in UTC.