1. Query API
English
  • Chinese
  • English
  • Open API Documentation
  • Payin
    • Payin Order - General
    • Payin Order - India
    • Payin Order - Philippines
    • Payin Order - Indonesia
    • Payin Order - Vietnam
    • Payin Order - Cryptocurrency
    • Payin Order - China
    • Payin Order - Malaysia
    • Payin Order - Pakistan
    • Payin Order - Thailand
  • Payout
    • Payout Order - General
    • Payout Order - India
    • Payout Order - Philippines
    • Payout Order - Indonesia
    • Payout Order - Vietnam
    • Payout Order - Cryptocurrency
    • Payout Order - Malaysia
    • Payout Order - Pakistan
    • Payout Order - Thailand
  • Callback Notification
    • Callback Description
    • Collection Callback
    • Payout Callback
  • Query API
    • Collection Order Query
    • Payout Order Query
    • Wallet Query
  • Examples of encryption and signature
    • Go Language Encryption and Signature Example
    • Python Encryption and Signature Example
    • PHP encryption and signature example
    • Node.js encryption and signature example
    • Environment variables and request body JSON example
    • Java encryption and signature example
  • Other instructions
    • Response Status Description
    • Order Status Description
    • Payment Method List
    • Bank Code List
    • Checkout iframe Copy Function Support Description
    • Backend Login Instructions
  1. Query API

Collection Order Query

Brief Description
Collection order query
Request URL
/api/v1/transactions/detail
Request Method
POST
Request Format
Content-Type: application/json

Request Parameters#

Field NameTypeDescriptionRequiredExample
order_noStringMerchant order numberNoTX10000000000001
trade_noStringPlatform transaction numberNoPI10000000000001
Request Example
{
  "order_no": "TX10000000000001",
  "trade_no": "PI10000000000001"
}

Response Parameter Description#

Note: please use due_settlement_amount as the user's actual settlement amount
Note: please use due_settlement_amount as the user's actual settlement amount
Note: please use due_settlement_amount as the user's actual settlement amount
Field NameTypeDescriptionRequiredExample
codeintResponse status code 200: request successful, otherwise refer to response status descriptionYes200
msgStringDescriptionYesSUCCESS
dataobjectSuccess dataYesContains the following data
trade_noStringPlatform transaction numberYesPI10000000000001
order_noStringMerchant order numberYesTX10000000000001
statusStringOrder status: PROCESSING-processing , SUCCEEDED-success, FAILED-failed ,EXPIRED-timeout ,CLOSED-closed ,REVERSAL-reversalYesPROCESSING
currencyStringCurrencyYesINR
amountStringOrder amountYes1000.00
due_pay_amountStringPayable amount (may differ from order amount due to discounts)Yes1000.00
actual_amountStringActual paid amount (user payment amount)No1000.00
due_settlement_amountStringSettlement amount (actual payout amount)No1000.00
settlement_amountStringSettlement amount (platform and merchant settlement amount)No1000.00
feeStringFeeNo100.00
complete_atLongOrder completion time, Unix timestamp: millisecondsNo1767315722
remarkStringTransaction remarkNo
payer_nameStringPayer nameNo
notify_urlStringCallback URLYes
user_ipStringUser IPYes
payment_methodStringPayment method code, please refer to payment method listYes
payment_linkStringPayment link, platform checkout linkYes
expires_atLongOrder expiration time, Unix timestamp: secondsYes3600
create_atLongCreation time, Unix timestamp: millisecondsYes1767315722000
protocolStringCryptocurrency transaction protocol (chain/network, e.g. TRC20, ERC20, BTC)No
hashStringCryptocurrency transaction hashNo
utrStringIndia UPI, bank transfer UTRNo
Response Example - Query Success
{
  "code": 200,
  "msg": "BIZ_OPERATION_SUCCESS",
  "data": {
    "trade_no": "PI2008893646698578001",
    "order_no": "pay-000012",
    "status": "EXPIRED",
    "amount": "1000.00",
    "due_pay_amount": "1000.00",
    "actual_amount": "500.00",
    "due_settlement_amount": "500.00",
    "settlement_amount": "495.00",
    "fee": "5",
    "currency": "INR",    
    "complete_at": 1767796146000,
    "remark": "",
    "payer_name": "",
    "notify_url": "http://localhost:8080/cb/test/Titan003",
    "user_ip": "10.10.2.108",
    "payment_method": "UPI",
    "payment_link": "http://checkout-ui-v1.payhub-dev.com/INR/PI2008893646698578001",
    "expires_at": 1767796143,
    "create_at": 1767315722000,
    "protocol": "",
    "hash": "",
    "utr": ""
  }
}
Response Example - Failure
{
  "code": 3001,
  "msg": "订单未找到",
  "data": null
}
Modified at 2026-05-29 14:35:24
Previous
Payout Callback
Next
Payout Order Query
Built with