Query Transaction API
✅ API Request Parameters(HTTP-Request-Body )
Params Name
Description
Required
Notes
action
Action name
Y
String, “PREPAY_QUERY”
version
Version number
Y
String, “2.0”
merchant_id
Merchant ID
Y
Provided by OTT Pay
data
Encrypted Transaction Data
Y
See "Data" table below
md5
Message Digest
Y
☑️ Request Example(JSON Data):
{
"action":"PREPAY_QUERY",
"version":"2.0",
"merchant_":"QC00005496",
"data": "zTadPG0YM4gD1WOFqxg7wn3vmU20NjCnCUOOnE9mTTkxYraQDflljA8W3azYG9MuOvOyl3cZhafH+io6PiWdZCwRmi3HGa19BvT215IIxRy2HvYe0Sqs2lxshm9E4y5F1gJ7HHMTqpY0wIA4DsuWA97UC55adB2G86VbanI7B5a3kErApr5mbAoE7wcNbDJfGh4CBbSoRxQyiGZ48SvYuIW/sclT4yu6okjo6CY3xL4=",
"md5":"6AFB2E94A70D9A208F101723700EB287"
}
☑️ Data(JSON Data, to be encrypted):
Params Name
Description
Required
Notes
prepay_order_id
Prepay order
Y
order_id
Order id
N
merchant_id
Merchant id
Y
✅ API Response Parameters(HTTP-Response-Body)
Params Name
Description
Required
Notes
rsp_code
Response code
Y
refer to Appendix B
rsp_msg
Response message
Y
data
Encrypted Data
Y
See "Data" table below
md5
Message Digest
Y
☑️ Response Example(JSON Data):
{
"rsp_code":"SUCCESS",
"rsp_msg":"success",
"data":"41kiLvjVBO8AW4wTOthI92OQu+8fwac5cIDx0DoZpitLvSJU8WKQbk5Bii5ZYrgLz4hepQ865QZFWqj2PRZ1FjxxipxEy2KoOKchWK09e42Se3CMAxt/+8UGrnAHDJLbU/BBlZLJoLpruSNKBeVfwhI7TtGdP4ciwzKPmv5aS2DWoU4Jl26IAPa8PeGhPNLuT99HwBGXa7aUz5adYk3uAR5Ww9HkBlPrqzJlUQ4zdMgjxaM2bROldcKTK8NxPM7X",
"md5":"32310A0DD3D021A7D0CDF6A5909A1A61"
}
☑️ Transaction Data(JSON format, After decrypted)
Params Name
Description
Required
Notes
rspCode
Inquiry Response code
Y
rspMsg
Inquiry Response message
Y
merchant_id
Merchant ID
Y
merchant_name
Y
amount
Payment amount
Y
tip
Tip Amount
N
shop_id
Store ID
Y
operator_id
Operator
Y
status
status
“SUCCESS”: payment successfully, ”ORDERCLOSE”: payment fail, ”PROCESSING”: payment on processing
call_back_url
Call back URL
redirect_url
Redirect URL
biz_type
Y
“PREPAY”
prepay_order_id
Prepay Order ID
Y
order_id
Order ID
N
Order_id in OTT Pay system, if the prepay order is implemented with a payments method, it will not be null
sale_num
Sale number
Y
The sale number or invoice number from merchant
Buyer email
N
remarks
Remarks
N
currency_type
currency
Y
CAD/USD/CNY
duration
Payment duration
Y
create_time
create time
Y
Only exist for a refunded order
expire_time
expire time
Y
payments_methods
Payment list
Y
The list of available payment to the prey pay order
Last updated
Was this helpful?