withdrawId) and paid on chain shortly after; follow it with Get single Withdrawal.amount when the request is registered; the receiver gets amount - fee (withdraw_fee in Tokens List). amount must be more than the fee.apiKey and secretKey appear in Dashboard → Profile → Gateway Setting → API Key Information. Keep the secret key on your server only.withdrawUniqueId (2–254 characters, unique across BityclePay, so prefix it, e.g. myexchange-48213). If your request times out and you're not sure it arrived, retry with the same withdrawUniqueId: a second request is rejected with WithdrawUniqueId already exists., which means the first one was registered (find it in Get Withdrawals, field withdraw_uniqueu_id).x-api-key: your API keyx-timestamp: current time in milliseconds; must be within 60 seconds of our clock (keep your server clock synced)x-signature: HMAC-SHA256, hex, with your secret key, of these values joined without separators:apiKey + merchantCode + timestamp + withdrawUniqueId + amount + chain + token + walletAddressamount without trailing zeros or exponent ("12.5", not "12.50" or "1.25e1"), withdrawUniqueId without spaces around it. We sign the number and the trimmed id, so "12.50" gives Invalid signature.status | Meaning |
|---|---|
PENDING | Registered, waiting to be paid. You can still cancel it in the dashboard (the amount comes back to your balance). |
ACCEPTED | Being paid on chain |
SUCCESS | Paid. trx_hash is the blockchain transaction. |
FAIL | Not paid; contact support |
CANCELLED | Cancelled; the amount is back in your balance |
curl --location 'https://chainhub.bitycle.com/v1/webservice/withdraw' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'x-timestamp: 1763202926000' \
--header 'x-signature: 9c2f0e4b7a1d3c5e8f6a2b4d0c9e7f1a3b5d8c6e2f4a0b9d7c1e3f5a8b6d2c4e' \
--header 'Content-Type: application/json' \
--data '{
"amount": "1200",
"token": "USDT",
"chain": "BSC",
"walletAddress": "0xFB0F2c1aE6B3d5a8C9E4f7b2A0d1c3e5f6A7b8C9",
"withdrawUniqueId": "myexchange-4789290084",
"description": "Withdraw 1200 USDT for user 56739"
}'{
"message": "Withdraw request registered successfully",
"data": {
"withdrawId": 293670
}
}