Webhooks

Receive real-time notifications about transfers, deposits, and events.

Events

Event	Description
transfer.completed	ETB transfer completed
disburse.completed	Partner disbursement completed
deposit.mint_queued	Deposit mint queued

Configure Webhook

HTTPPUT

curl -X PUT https://api.etbx.com/api/v1/partners/webhook \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"webhookUrl": "https://your-app.com/webhooks/etbx"}'

Payload

Payloadjson

{
  "event": "transfer.completed",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "id": "tx_abc123",
    "amountEtb": 100,
    "txHash": "0xabc123..."
  }
}

Verification

Verify using X-Webhook-Signature header with HMAC-SHA256:

Headerhttp

X-Webhook-Signature: sha256=abc123...

Retry Policy

ETBX retries failed webhooks up to 3 times with exponential backoff:

Attempt 1: 30 seconds
Attempt 2: 2 minutes
Attempt 3: 8 minutes