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 仍为符合全部条件的总数。

GET

https://staging-api.billbuddyhq.com

/

api

/

v2

/

trans

/

list

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
  }
}

授权

Authorization

string

header

必填

OAuth2 client_credentials 授权。access_token 到期后重新获取。

查询参数

Mid

string | null

业务标识，可选；须属于当前认证商户。省略时查询全部所属业务。

Maximum string length: 20

order_number

string | null

BillBuddy 交易号，精确匹配；与其他筛选条件共同生效。

Maximum string length: 60

merchant_order_no

string | null

调用方订单号，精确匹配；与其他筛选条件共同生效。

Maximum string length: 64

start_date

string<date> | null

交易创建日期下限（含当天），须与 end_date 成对提交。省略两者时从今天前 6 天开始。日期窗口边界见接口说明。

end_date

string<date> | null

交易创建日期上限（含当天），须与 start_date 成对提交，且不早于起日；窗口最多三个日历月，边界见接口说明。

page

integer | null

默认值:1

页码，从 1 开始，默认 1。

必填范围: x >= 1

size

integer | null

默认值:20

每页条数，默认 20，最大 50。

必填范围: 1 <= x <= 50

响应

HTTP 200；code=0 查询成功，code=400 参数错误，code=1 业务或认证失败。

Option 1
Option 2

交易列表查询成功。

code

enum<integer>

必填

请求成功；每笔交易状态见 list。

可用选项:

0

message

string

必填

处理结果说明，成功为 ok。

data

object

必填

筛选结果与分页信息。

Show child attributes