Execute

Guarantees for Execute

• Funds are locked immediately

• Duplicate order_id requests are idempotent

• Multi-source payouts are planned atomically

• Status transitions are deterministic

• All amounts use human-readable units

Common Parameters

These parameters are used to create and submit a payout order based on previously validated conditions.

During this step:

• required funds are locked immediately

• payout tasks are queued for execution

• blockchain transactions are prepared and dispatched

This operation results in a real payout process and is irreversible once broadcasted.

Execute Payout

POST https://api-processing.crypto-chief.com/v1/payout/execute

Headers

Name	Value
Content-Type	application/json
Signature	Signed request body
Merchant	Merchant ID

Body

Name	Type	Description	Required
order_id	string	Idempotency key	true
amount	string	Requested payout amount (human units)	true
network	CHAIN	Target blockchain network	true
coin	COIN	Asset to be sent	true
to_address	string	Recipient address	true
memo	string	Optional memo / destination tag (for supported networks)	false
from_addresses	string[]	Whitelist of Master Wallet addresses allowed as payout sources	false
allow_multiple_sources	bool	Allow splitting payout across multiple Master Wallets. Default: false	false
auto_convert	bool	Enable automatic conversion from other assets (not implemented)	false
auto_convert_policy	ASSET_POLICY	Conversion rules configuration (reserved for future use)	false
max_fee_amount_fiat	string	Maximum allowed total fee in USD (gas + refuel)	false
url_callback	string	Webhook URL	true

Response

200

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

  "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": null
  },

  "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": null,
      "fee_paid_fiat": null,
      "txid": null
    },
    {
      "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": null,
      "fee_paid_fiat": null,
      "txid": null
    }
  ],

  "service_operations": [
    {
      "type": "gas_refuel",
      "context": "payout_prepare",
      "status": "planned",
    
      "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": null,
      "fee_paid_fiat": null,
    
      "txid": null
    }
  ],

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

400

Asset Object

Name	Type	Required	Description
coin	​COIN​	true	The cryptocurrency ticker symbol (e.g., "USDT", "BTC", "ETH").
network	​CHAIN​	true	The blockchain network code (e.g., , ETH_MAINNET , TRON_MAINNET). Use "ANY" to indicate all available networks for this coin.

JSON example

{
  "coin": "USDT",
  "network": "TRON_MAINNET"
}

ASSETS_POLICY Object

Used in the assets parameter to filter the payment methods shown to the user.

Name	Type	Required	Description
allow	​ASSET []	false	Whitelist. An array of Asset objects. If provided, the user will see only these assets. All others are hidden.
exclude	​ASSET []	false	Blacklist. An array of Asset objects. These specific assets will be hidden from the user.

JSON example

{
  "allow": [
    { "coin": "USDT", "network": "ANY" }
  ],
  "exclude": [
    { "coin": "BTC", "network": "ANY" }
  ]
}