API

Blnk webhook

Receive Blnk Core webhook events and inject transactions into Watch for real-time risk evaluation.

POST/blnkwebhook

Use this endpoint when Blnk Core sends transaction events to Watch through a transaction hook. Watch unwraps the webhook payload, injects the transaction, and evaluates it against your active instructions.

This follows the same evaluation flow as inject transaction. After processing, use get verdict to read the result, or configure ALERT_WEBHOOK_URL to receive alerts when rules match.

Body

eventstringrequiredbody

The Blnk webhook event name. For example, transaction.created.

dataobjectrequiredbody

The transaction object from Blnk Core. Field names match Blnk transaction naming - transaction_id, amount, currency, source, destination, created_at, meta_data, and so on.

curl -X POST http://localhost:8081/blnkwebhook \
  -H "Content-Type: application/json" \
  -d '{
    "event": "transaction.created",
    "data": {
      "transaction_id": "txn_123",
      "amount": 1000.00,
      "currency": "USD",
      "source": "balance_123",
      "destination": "balance_456",
      "reference": "ref_001",
      "status": "applied",
      "created_at": "2026-03-16T09:00:00Z",
      "meta_data": {
        "source_country": "US"
      }
    }
  }'

Transaction txn_123 from webhook event 'transaction.created' processed successfully

Error decoding webhook payload

Error processing transaction: ...

Notes

If data.transaction_id is missing, Watch generates a UUID before evaluation.
If data.created_at is missing, Watch uses the current server time.
On success, the response body is plain text, not JSON.