1. Wallet as a Service(WaaS)
Bitycle Business
English
  • English
  • Turkish
  • Getting started
  • Bitycle Widget
    • introduction
    • demo
    • widgets
      • Advance Chart
      • Full Chart
      • Overview Chart
      • Fear & Greed
      • Technical Analysis
      • Mini Chart
      • Trends
      • Compare
      • Treemap
      • Ticker
      • Digest(AI)
      • News
      • Info
  • Bitycle Lab
    • Introduction
    • Wallet as a Service(WaaS)
      • Introduction
      • Quick start
      • Concepts
      • Callbacks
      • Errors & FAQ
      • Buy TRON Energy & Bandwidth
      • Tokens List
        GET
      • Get Balance
        GET
      • Request Ramzlink
        POST
      • Callback New Payment
        POST
      • Get Ramzlink Status
        GET
      • Request Wallet (VIP)
        POST
      • Inquiry payment
        POST
      • Request Withdrawal
        POST
      • Get single Withdrawal
        GET
      • Get Deposits
        GET
      • Get Withdrawals
        GET
    • Blockchain Indexer
      • introduction
      • Blockchain List
      • Contract Info
      • Get Balances
    • Security&Privacy
      • introduction
      • Check Blocked Wallets
      • Add to watch list
      • Get watch list
      • Delete from watch list
      • Get address label
      • Get address information
    • Node as a Service(NaaS)
      • introduction
    • Tokenization
      • introduction
    • Decentralized Storage(IPFS)
      • introduction
    • Hyperledger Services
      • introduction
  • Bitycle Cap
    • introduction
    • Coins
      • introduction
      • Coin List
      • Coin Info
      • Coin Price
      • coin exchange listings
    • Markets
      • introduction
      • Market Price
      • Markets Price
      • Markets List
      • Markets frame info
      • market sparklines
    • exchanges
      • introduction
      • CEX Aggregator(Buy&Sell)
        • introduction
        • get tradable markets
        • get tradable markets price
        • send otc order
        • get orders
        • get balances
      • Exchanges List
      • Exchange Info
      • Exchange Coins Listing
      • Exchange Markets Listing
  • Schemas
    • wallet
  1. Wallet as a Service(WaaS)

Request Withdrawal

POST
/v1/webservice/withdraw
Sends tokens from your balance to any wallet address. The request is registered at once (HTTP 201 with a withdrawId) and paid on chain shortly after; follow it with Get single Withdrawal.
Money: your balance is reduced by amount when the request is registered; the receiver gets amount - fee (withdraw_fee in Tokens List). amount must be more than the fee.
Enable it first: the withdrawal API is off by default. Ask the BityclePay admin to enable it for your account. Once it's on, your apiKey and secretKey appear in Dashboard → Profile → Gateway Setting → API Key Information. Keep the secret key on your server only.

withdrawUniqueId: protection against paying twice#

Give every new withdrawal its own 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).

Signature#

Three headers:
x-api-key: your API key
x-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 + walletAddress
Sign exactly the text you send, and write it in its simplest form: amount 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.

Node.js#

Python#

curl#

Status of a withdrawal#

statusMeaning
PENDINGRegistered, waiting to be paid. You can still cancel it in the dashboard (the amount comes back to your balance).
ACCEPTEDBeing paid on chain
SUCCESSPaid. trx_hash is the blockchain transaction.
FAILNot paid; contact support
CANCELLEDCancelled; the amount is back in your balance

Request

Header Params

Body Params application/json

Examples

Responses

🟢201Success
application/json
Registered
Bodyapplication/json

🟠403Wrong IP
🟠422Invalid request
Request Request Example
Shell
JavaScript
Java
Swift
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"
}'
Response Response Example
201 - Success Example
{
    "message": "Withdraw request registered successfully",
    "data": {
        "withdrawId": 293670
    }
}
Modified at 2026-11-18 07:20:58
Previous
Inquiry payment
Next
Get single Withdrawal
Built with