curl --get "${BASE_URL}/api/v2/trans/queryTrans" \
-H "Authorization: Bearer ${ACCESS_TOKEN}" \
-H "Accept: application/json" \
--data-urlencode merchant_id=48290713 \
--data-urlencode order_number=b1893452400000741
{
"code": 0,
"message": "ok",
"data": {
"business_id": "7294815",
"merchant_id": "48290713",
"order_number": "b1893452400000741",
"merchant_order_no": "ORDER-20300101-001",
"trans_type": 1,
"trans_type_text": "Payment",
"original_order_number": null,
"status": 1,
"status_text": "Successful",
"amount": "10.00",
"currency": "AUD",
"surcharge_amount": "0.50",
"surcharge_currency": "AUD",
"payment_amount": "10.50",
"payment_currency": "AUD",
"created_at": "01/01/2030 10:00:00",
"complete_date": "01/01/2030 10:00:05",
"process_date": null,
"cancelled_at": null,
"expired_at": null,
"payment_method": {
"type": 2,
"type_text": "Credit",
"card_brand": "Visa",
"wallet_type": null
},
"result": "Successful"
}
}
交易
查询单笔交易
查询已有支付、退款或争议交易的当前状态。使用 OAuth2 Bearer Token，无需请求签名。order_number 与 merchant_order_no 至少提供一个，同时提供时必须匹配同一笔交易。第三方凭证匹配多笔时返回 code=1，请补充 BillBuddy 交易单号。
code=0 表示查询成功；支付结果以 data.status 为准。已取消的交易优先返回 result=Cancelled，同时仍返回该交易的 status。金额以主货币单位、两位小数字符串返回。时间使用 Australia/Sydney（适用夏令时）；格式见各字段。查询仅返回当前状态，不会发起或重新执行支付。未查询到交易时，请先核实订单信息和处理状态，不要直接重新扣款。
merchant_id 为可选业务筛选条件，省略或为空时查询当前认证商户的全部业务；传入时仅查询指定业务。若订单凭证在多个业务中重复，可指定 merchant_id 缩小范围，或补充 order_number 唯一定位交易。
GET
/
api
/
v2
/
trans
/
queryTrans
curl --get "${BASE_URL}/api/v2/trans/queryTrans" \
-H "Authorization: Bearer ${ACCESS_TOKEN}" \
-H "Accept: application/json" \
--data-urlencode merchant_id=48290713 \
--data-urlencode order_number=b1893452400000741
{
"code": 0,
"message": "ok",
"data": {
"business_id": "7294815",
"merchant_id": "48290713",
"order_number": "b1893452400000741",
"merchant_order_no": "ORDER-20300101-001",
"trans_type": 1,
"trans_type_text": "Payment",
"original_order_number": null,
"status": 1,
"status_text": "Successful",
"amount": "10.00",
"currency": "AUD",
"surcharge_amount": "0.50",
"surcharge_currency": "AUD",
"payment_amount": "10.50",
"payment_currency": "AUD",
"created_at": "01/01/2030 10:00:00",
"complete_date": "01/01/2030 10:00:05",
"process_date": null,
"cancelled_at": null,
"expired_at": null,
"payment_method": {
"type": 2,
"type_text": "Credit",
"card_brand": "Visa",
"wallet_type": null
},
"result": "Successful"
}
}
授权
OAuth2 client_credentials 授权。access_token 到期后重新获取。
查询参数
可选业务标识，最长20个字符；传入时必须属于当前认证商户。省略或为空时在该商户全部业务范围内定位交易。
Maximum string length:
20BillBuddy 交易单号，与 merchant_order_no 至少提供一个；同时提供时必须对应同一笔交易。
Maximum string length:
60第三方订单凭证，与 order_number 至少提供一个；若匹配多笔交易，须补充 order_number。
Maximum string length:
64