curl --get "${BASE_URL}/api/v2/trans/list" \
-H "Authorization: Bearer ${ACCESS_TOKEN}" \
-H "Accept: application/json" \
--data-urlencode page=1 \
--data-urlencode size=20{
"code": 0,
"message": "ok",
"data": {
"list": [
{
"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": "15/01/2030 10:32:41",
"complete_date": "15/01/2030 10:32:43",
"process_date": null,
"cancelled_at": null,
"expired_at": null,
"payment_method": {
"type": 2,
"type_text": "Credit",
"card_brand": "Visa",
"wallet_type": null
},
"result": "Successful"
}
],
"page": 1,
"size": 20,
"total": 1
}
}查询交易列表
查询当前认证商户的交易，按最新记录在前分页返回；仅查询记录，不会重新支付。
Mid 为可选业务标识，大小写必须保持一致。指定时仅查询该业务，省略时查询当前商户的全部业务；不能访问其他商户的业务。此接口使用 Mid，不使用 merchant_id。
start_date 与 end_date 必须同时提供或同时省略，格式为 YYYY-MM-DD。按交易创建日期筛选，包含起止日，使用 Australia/Sydney 时区（含夏令时）。省略时查询今天及之前 6 天，共 7 个自然日。end_date 不得早于 start_date。日期窗口不得超过三个日历月：从 start_date 当日零时到 end_date 次日零时，不能超过 start_date 加三个月的零时；若目标月份没有同日，取该月月末。例如 2026-01-31 至 2026-04-29 可查询，至 2026-04-30 超限。
order_number 和 merchant_order_no 均为可选精确匹配条件，同时提供时必须匹配同一笔交易；订单号筛选仍受日期和业务筛选限制。page 默认 1，size 默认 20、最大 50。没有匹配或页码超出范围时 list=[]，total 仍为符合全部条件的总数。
curl --get "${BASE_URL}/api/v2/trans/list" \
-H "Authorization: Bearer ${ACCESS_TOKEN}" \
-H "Accept: application/json" \
--data-urlencode page=1 \
--data-urlencode size=20{
"code": 0,
"message": "ok",
"data": {
"list": [
{
"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": "15/01/2030 10:32:41",
"complete_date": "15/01/2030 10:32:43",
"process_date": null,
"cancelled_at": null,
"expired_at": null,
"payment_method": {
"type": 2,
"type_text": "Credit",
"card_brand": "Visa",
"wallet_type": null
},
"result": "Successful"
}
],
"page": 1,
"size": 20,
"total": 1
}
}授权
OAuth2 client_credentials 授权。access_token 到期后重新获取。
查询参数
业务标识，可选；须属于当前认证商户。省略时查询全部所属业务。
20BillBuddy 交易号，精确匹配；与其他筛选条件共同生效。
60调用方订单号，精确匹配；与其他筛选条件共同生效。
64交易创建日期下限（含当天），须与 end_date 成对提交。省略两者时从今天前 6 天开始。日期窗口边界见接口说明。
交易创建日期上限（含当天），须与 start_date 成对提交，且不早于起日；窗口最多三个日历月，边界见接口说明。
页码，从 1 开始，默认 1。
x >= 1每页条数，默认 20，最大 50。
1 <= x <= 50