Skip to main content

Webhooks

Receive instant notifications for Deposits, payments and Withdrawals.

Register a Webhook​

You only need to register one URL. We will send all events to this address.

Endpoint: POST /webhooks Headers: x-api-key: <key> OR Authorization: Bearer <token>

Request Body:

{
  "url": "https://your-server.com/webhooks/koinflow"
}

Response:

{
  "success": true,
  "data": {
    "id": "webhook-uuid",
    "url": "https://your-server.com/webhooks/koinflow",
    "event": "*",
    "is_active": true
  }
}

Event Payload​

When a transaction occurs (Deposit or Withdrawal), Koinflow sends a POST request to your URL.

Headers:

  • Content-Type: application/json
  • X-Webhook-Signature: hmac_sha256(payload, secret) (Verify this for security!)

Payload Example:

{
  "id": "notification-uuid",
  "event": "transaction.deposit",
  "timestamp": "2024-12-07T12:00:00Z",
  "data": {
    "transactionId": "tx_12345",
    "txHash": "0xabc...",
    "amount": "100.00",
    "asset": "USDT",
    "blockchain": "TRON",
    "fromAddress": "T...",
    "status": "confirmed"
  }
}