PayOut Webhook

PayOut Webhook

PayOut webhooks are sent only when the payout order status changes and only after atomic execution steps are completed. Intermediate internal operations (gas refuel, partial transfers, retries) do not trigger webhooks individually.

PayOut status flow

The payout lifecycle differs slightly depending on the blockchain network.

BTC-based networks

queue
  -> in_mempool
  -> confirm_check
  -> paid

• queue — payout accepted and queued for execution

• in_mempool — transaction detected in the Bitcoin mempool

• confirm_check — transaction confirmed on-chain, awaiting required confirmations

• paid — payout successfully completed

Other networks (EVM, TRON, TON, etc.)

queue
  -> confirm_check
  -> paid

• queue — payout accepted and queued for execution

• confirm_check — transaction detected on-chain

• paid — payout successfully completed

The in_mempool state is skipped on most non-BTC networks.

Webhook delivery rules

• Webhooks are sent only on status transitions

• A webhook is dispatched after all related on-chain actions are completed atomically

• No webhooks are sent for:

  • individual internal transactions

  • service operations (e.g. gas refuel)

  • partial execution steps

Each webhook represents a consistent and finalized state of the payout at that stage.

Request Example

{
  "event": "payout.paid",

  "uuid": "b0d1f7f9-1eaa-4c2f-8f9b-2b0d1b0b9f11",
  "order_id": "withdraw-100-001",
  "status": "paid",

  "amount_requested": "100.00",
  "amount_to_receive": "100.00",

  "fee_info": {
    "fee_mode": "service",
    "estimated_fiat": "1.27",
    "limit_fiat": "2.00",
    "limit_currency": "USD",
    "total_fee_paid_fiat": "1.22"
  },

  "sources": [
    {
      "address": "0xA1b2c3d4e5f6",
      "network": "ETH_MAINNET",
      "coin": "USDT",
      "amount_crypto": "60.00",

      "need_refuel": false,
      "refuel_amount": "0",

      "estimated_fee": "0.00045",
      "estimated_fee_fiat": "0.58",

      "fee_paid": "0.00043",
      "fee_paid_fiat": "0.55",

      "txid": "0xaaa111..."
    },
    {
      "address": "0xF9e8d7c6b5a4",
      "network": "ETH_MAINNET",
      "coin": "USDT",
      "amount_crypto": "40.00",

      "need_refuel": true,
      "refuel_amount": "0.003",

      "estimated_fee": "0.00038",
      "estimated_fee_fiat": "0.49",

      "fee_paid": "0.00036",
      "fee_paid_fiat": "0.47",

      "txid": "0xbbb222..."
    }
  ],

  "service_operations": [
    {
      "type": "gas_refuel",
      "context": "payout_prepare",
      "status": "completed",

      "network": "ETH_MAINNET",
      "coin": "ETH",
      "amount_native": "0.003",

      "from_address": "0xSERVICE_WALLET",
      "to_address": "0xF9e8d7c6b5a4",

      "estimated_fee": "0.00021",
      "estimated_fee_fiat": "0.20",

      "fee_paid": "0.00019",
      "fee_paid_fiat": "0.18",

      "txid": "0xrefuel123..."
    }
  ],

  "created_at": "2026-01-29T01:25:00Z",
  "completed_at": "2026-01-29T01:32:41Z"
}