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)

Quick start

BityclePay gives your users crypto deposit addresses, tells your server when a deposit arrives, and sends withdrawals. This page takes you from zero to your first real deposit and callback in about 15 minutes.
All requests go to https://chainhub.bitycle.com with JSON bodies.

1. Pick your model#

Ramzlink (payment link)VIP wallet (permanent addresses)
Made forShops: one payment per orderExchanges, wallets, platforms with user balances
You getA hosted payment page to send your customer toDeposit addresses per user, shown in your own app
AddressTemporary, per invoice (watched for 24 hours)Permanent, per user (terminal), watched forever
AmountFixed (required_amount), can be paid in partsAny amount, any time, as often as the user wants
Tokens creditedThe invoice's token onlyEvery supported token
CallbackInvoice status after each depositterminalId + trxRefId for each deposit
You confirm withGet Ramzlink StatusInquiry payment
NeedsMerchant codeMerchant code + VIP account (ask support)
Both can be used side by side on the same account and balance.

2. Get your merchant code#

In the dashboard open Profile → Gateway Setting. The Payment GateWay (Merchant Code) field is your merchant code.
Send it in every request:
Authorization: Token YOUR_MERCHANT_CODE
Keep it on your server: anyone with it can create payments and read your account. If you call us from fixed servers, also set Server IP on the same page; requests from other IPs are then rejected.
VIP accounts also see on that page their Terminal (Nonce) Start / End and the API Key Information (API key and secret key, for withdrawals).
Check that it works:
You get your balance per token. A 401 means the code is wrong.

3. Get a test callback URL#

Open webhook.site and copy Your unique URL. Use it as callback_url below: every callback we send shows up there live, with its body and headers, so you can see exactly what your server will receive. (Anyone with that URL can see the requests. Use it for tests only.)
There is no testnet: test with a small real deposit, for example 2–5 USDT on BSC or Polygon, where network fees are low. The deposit is credited to your balance (minus our fee), so it isn't lost.

4a. Ramzlink: your first payment#

Create an invoice for 5 USDT:
Answer (HTTP 201):
{
  "message": "invoice created",
  "invoice": {
    "invoiceNumber": "6560cdb2",
    "invoiceLink": "https://pay.bitycle.io/fa/invoice/fOdPI023YC",
    "token": "USDT",
    "createTime": "2026-11-15T10:35:26.000Z",
    "expirationTime": "2026-11-15T12:35:26.000Z"
  }
}
1.
Open invoiceLink, choose a network (for example BSC) and send 5 USDT from any wallet to the address shown.
2.
A few minutes later the callback appears on webhook.site:
{ "invoice": { "status": "SUCCESS", "invoice_link": "fOdPI023YC", "token": "USDT", "required_amount": "5.00000000", "total_deposits": "5.00000000", "deposits_count": 1, "...": "..." } }
3.
Confirm it, with the last part of invoiceLink:
status: "SUCCESS" means fully paid. depositsHistory lists each deposit with its transaction hash.

4b. VIP wallet: your first deposit#

Ask for the addresses of your first terminal, the Terminal (Nonce) Start number from Gateway Setting (here 300000):
Answer:
{
  "terminalId": 300000,
  "token": "USDT",
  "addresses": [
    { "address": "0x0Af8e9cc82ed86BA382C2CeBb08DCA4F7809018c", "displayName": "BSC(BEP20)", "chainName": "BSC", "minDeposit": 0.3 },
    { "address": "TQ5NbM2k8qF3vKp1oWzR7yHn4dXcJ6sLtE", "displayName": "Tron(TRC20)", "chainName": "Tron", "minDeposit": 1.5 }
  ]
}
1.
Send 2 USDT on BSC to the BSC address. Send more than minDeposit: a deposit of that amount or less is taken completely as fee.
2.
A few minutes later the callback appears on webhook.site:
{ "terminalId": "300000", "trxRefId": "0x55a13a230a4db3b0d4c1e7f8a2b9d6e3f0c5a8b7d4e1f2a3b6c9d8e7f0a1b2c3", "callback_url": "https://webhook.site/YOUR-UNIQUE-ID" }
3.
Ask for the details with the two values from the callback:
You get status: "SUCCESS", token, amount, fee, network and the hash. Credit your user from this answer.
Each of your users gets their own terminal (300001, 300002, …). Save it with the user: the same terminal always returns the same addresses.

5. Before you go live#

Your callback endpoint answers any 2xx within 10 seconds, and does its work afterwards. See Callbacks.
Confirm every callback with Inquiry / Get Ramzlink Status before you credit or ship anything, and credit each trxRefId only once.
Show the minimum (minDeposit) and the networks from the addresses list next to each address.
Set Server IP in Gateway Setting if your servers have fixed IPs.
Keep secrets on the server: the merchant code and the secret key never go into a mobile app, a browser or a public repo.
Reconcile once a day with Get Deposits.
If a callback is missing, open the deposit in the dashboard: its Callback section shows what your server answered, and Send callback again sends it again.
Next: Concepts · Callbacks · Errors & FAQ
Modified at 2026-11-18 06:07:15
Previous
Introduction
Next
Concepts
Built with