PayOut Webhook

PayOut Webhook

PayOut webhooks are sent only when the payout order reaches a final state (paid or system_fail). Intermediate internal operations (gas refuel, auto-topup, partial transfers, retries) do not trigger webhooks.

PayOut Status Flow

The payout lifecycle differs depending on the blockchain network.

EVM networks (ETH, BSC, Polygon, Arbitrum, Base, Optimism, Avalanche, etc.)

queue → sending → broadcasting → confirm_check → paid

With gas refuel (when source wallet lacks native currency for gas):

queue → refueling → refuel_confirmed → sending → broadcasting → confirm_check → paid

Status	Description
queue	Payout accepted and queued for processing.
refueling	Gas refuel transaction sent to prepare the source wallet.
refuel_confirmed	Gas refuel confirmed, payout transaction will be sent next.
sending	Payout transaction is being broadcast to the network.
broadcasting	Transaction is queued in the EVM pipeline, waiting to be broadcast to the network. The platform polls the pipeline until the transaction reaches the mempool.
confirm_check	Transaction detected on-chain, awaiting required confirmations.
paid	Payout successfully completed.

BTC-family networks (BTC, LTC, DOGE, BCH, DASH)

queue → sending → in_mempool → confirm_check → paid

Status	Description
queue	Payout accepted and queued for processing.
sending	Payout transaction is being broadcast to the network.
in_mempool	Transaction visible in the mempool, waiting to be included in a block.
confirm_check	Transaction included in a block, awaiting required confirmations.
paid	Payout successfully completed.

Other networks (TRON, TON, SOL, XRP, etc.)

queue → sending → confirm_check → paid

With gas refuel (when source wallet lacks native currency for gas):

queue → refueling → refuel_confirmed → sending → confirm_check → paid

Status	Description
queue	Payout accepted and queued for processing.
refueling	Gas refuel transaction sent to prepare the source wallet.
refuel_confirmed	Gas refuel confirmed, payout transaction will be sent next.
sending	Payout transaction is being broadcast to the network.
confirm_check	Transaction detected on-chain, awaiting required confirmations.
paid	Payout successfully completed.

Failure

Status	Description
system_fail	Payout failed after retries or timeout. See error_reason for details.

Webhook Delivery Rules

• Webhooks are sent only on final states: paid or system_fail.

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

• No webhooks are sent for:

  • intermediate status transitions (sending, refueling, broadcasting , in_mempool, etc.)

  • individual internal transactions

  • service operations (e.g. gas refuel)

  • partial execution steps or retries

Each webhook represents the final, consistent state of the payout.

Webhook Payload Example

{
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "order_id": "order-001",
  "user_id": "user-123",
  "status": "paid",

  "amount_requested": "100.00",
  "amount_to_receive": "100.00",
  "to_address": "0x1234567890abcdef",

  "fee_info": {
    "fee_mode": "service",
    "estimated_fiat": "1.27",
    "limit_fiat": "5.00",
    "limit_currency": "USD",
    "total_fee_paid_fiat": "1.20"
  },

  "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"
}

Payload Field Reference

Field	Description
uuid	Unique payout operation identifier.
order_id	Your order identifier (as provided in the create request).
status	Final status: paid or system_fail.
amount_requested	Original requested payout amount.
amount_to_receive	Actual amount the recipient receives.
fee_info.total_fee_paid_fiat	Total fees paid in USD (payout gas + refuel gas combined).
sources	Array of source wallets used for the payout. Each entry includes the transaction hash (txid) and actual fees paid.
service_operations	Platform-performed operations (gas refuels). Only present when refueling was required.
created_at	When the payout was created.
completed_at	When the payout reached its final state. null for system_fail.