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)
      • Tokens List
        GET
      • Get Balance
        GET
      • Request Ramzlink
        POST
      • Get Ramzlink Status
        GET
      • Request Wallet (VIP)
        POST
      • Callback New Payment
        POST
      • Inquiry payment
        POST
      • Request Withdrawal (VIP)
        POST
      • Get single Withdrawal
        GET
      • Get Deposits
        GET
      • Get Withdrawals
        GET
      • Buy TRON Energy & Bandwidth
        POST
      • Inquiry payment without trxRefId
        POST
      • Callback New Payment
        POST
    • 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)

Callback New Payment

POST
/
We call you: this is the request BityclePay sends to the callback_url you gave, right after a deposit is credited to your balance. Read the Callbacks page for the full guide.
VIP terminal (Request Wallet): {terminalId, trxRefId, callback_url}, one call per deposit. trxRefId is the deposit's transaction hash. Get the amount, token and network with Inquiry payment.
Ramzlink invoice: {invoice: {...}}, one call per deposit to the invoice, with the invoice's new status and total_deposits. Confirm with Get Ramzlink Status.
Your answer: any HTTP 2xx within 10 seconds. Answer first, then do your own processing.
Retries: when your server doesn't answer 2xx in time, we try again after 1, 10, 30 and 60 minutes (5 attempts). You can also send it again from the dashboard (deposit details → Callback → Send callback again).
Security: callbacks are not signed. Never credit a user from the callback body alone: always confirm with Inquiry / Get Ramzlink Status (they need your merchant code), and credit each trxRefId only once (the same callback can arrive more than once).

Request

Body Params application/json

Examples

Responses

🟢200Success
application/json
Any 2xx within 10 seconds means "received". The body is ignored.
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://chainhub.bitycle.com/' \
--header 'Content-Type: application/json' \
--data '{
    "terminalId": "300001",
    "trxRefId": "0x55a13a230a4db3b0d4c1e7f8a2b9d6e3f0c5a8b7d4e1f2a3b6c9d8e7f0a1b2c3",
    "callback_url": "https://api.your-exchange.com/bitycle/callback"
}'
Response Response Example
{}
Modified at 2026-11-17 17:37:24
Previous
Inquiry payment without trxRefId
Next
introduction
Built with