Webhook Notification - Transaction Failed | SQRIL

curl -X POST https://api.sqril.com/webhooks/transactions \
     -H "X-SQRIL-Signature: {{webhook_signature}}" \
     -H "Content-Type: application/json" \
     -d '{
  "tx_id": "tx_1234567890_abc123",
  "status": "FAILED",
  "error_message": "Transaction failed",
  "sender": {
    "name_first": "John",
    "name_last": "Doe",
    "country": "MY",
    "ic_number": "123456789012",
    "ic_type": "NIC",
    "phone": "+60123456789",
    "email": "john.doe@example.com"
  },
  "recipient": {
    "name_first": "Jane",
    "name_last": "Smith",
    "country": "ID",
    "account_no": "1234567890",
    "bank_code": "014",
    "bank_name": "Bank BCA"
  }
}'

{
  "received": true,
  "message": "Webhook processed successfully"
}

Example webhook notification sent by SQRIL when a transaction is finalized as failed.

When it is sent:

After provider processing marks the transaction failed.
Sent to all active webhook configs whose event filter matches transaction.failed.

Payload notes:

Required fields: tx_id, status (FAILED).
Optional fields: error_message, sender, recipient, and fee fields (if present).
error_message describes why the transaction failed.

Headers:

Content-Type: application/json
User-Agent: SQRIL-Webhook/
X-SQRIL-Signature only when a webhook secret is configured.

Example webhook notification sent by SQRIL when a transaction is finalized as failed. **When it is sent:** - After provider processing marks the transaction failed. - Sent to all active webhook configs whose event filter matches `transaction.failed`. **Payload notes:** - Required fields: `tx_id`, `status` (`FAILED`). - Optional fields: `error_message`, `sender`, `recipient`, and fee fields (if present). - `error_message` describes why the transaction failed. **Headers:** - `Content-Type: application/json` - `User-Agent: SQRIL-Webhook/` - `X-SQRIL-Signature` only when a webhook secret is configured.

Request

This endpoint expects an object.

tx_idstringRequired

statusstringRequired

error_messagestringRequired

senderobjectRequired

recipientobjectRequired

Response

receivedboolean

messagestring