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)

Inquiry payment

POST
/pg/v1/inquiryPay
Deposits of a VIP terminal, from our side. Two ways to call it:
You sendYou getUse it
terminalId + trxRefIdtransaction: that one depositWhen a callback arrives: credit your user from this answer, not from the callback
terminalId only (+ page, perPage)transactions: a page of the terminal's deposits, newest firstWhen you have no trxRefId
One deposit (with trxRefId)
amount is what was sent; your balance received amount - fee.
status is SUCCESS for a credited deposit.
trxRefId and trx_hash are the same transaction hash.
Works for any deposit of the terminal, also old ones. Unknown → HTTP 404 transaction not found!.
List (without trxRefId)
Not a full history: it lists only deposits whose funds are still on the terminal's address. After we sweep the address (a regular on-chain settlement), those deposits drop out. For the full history use Get Deposits.
An empty list is data: [] (HTTP 200), not an error.
Limit: 60 requests per minute.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200success
application/json
transaction when you sent a trxRefId, transactions when you did not
Bodyapplication/json

🟠404Not found
🟠422Invalid request
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://chainhub.bitycle.com/pg/v1/inquiryPay' \
--header 'Authorization: Token YOUR_MERCHANT_CODE' \
--header 'Content-Type: application/json' \
--data '{
    "terminalId": "300001",
    "trxRefId": "0x55a13a230a4db3b0d4c1e7f8a2b9d6e3f0c5a8b7d4e1f2a3b6c9d8e7f0a1b2c3"
}'
Response Response Example
200 - One deposit (with trxRefId)
{
    "transaction": {
        "terminalId": "300001",
        "token": "USDT",
        "trxRefId": "0x55a13a230a4db3b0d4c1e7f8a2b9d6e3f0c5a8b7d4e1f2a3b6c9d8e7f0a1b2c3",
        "status": "SUCCESS",
        "amount": "500.00000000",
        "fee": "0.30000000",
        "trx_hash": "0x55a13a230a4db3b0d4c1e7f8a2b9d6e3f0c5a8b7d4e1f2a3b6c9d8e7f0a1b2c3",
        "to": "0x0Af8e9cc82ed86BA382C2CeBb08DCA4F7809018c",
        "network": "BSC",
        "description": "User 586230"
    }
}
Modified at 2026-11-17 17:37:24
Previous
Callback New Payment
Next
Request Withdrawal (VIP)
Built with