版本:202607
批量查询订单交易列表
GET/openapi/2026-07/orders/transactions
批量查询多个指定订单下的全部交易记录,包含交易状态、支付渠道、金额及 网关返回信息等。
请求
Query参数
authorized: 已授权但尚未扣款void: 已取消processing: 处理中success: 交易成功failure/error: 交易失败,数据中两个值都存在,按失败过滤时需分别查询refunding: 退款中refunded: 已退款refund_failed: 退款失败expired: 已过期
order_ids string[]
待查询的订单 ID 列表,单次最多 50 个。 示例:?order_ids=1001&order_ids=1002
cursor string
分页游标
page_size int32
每页交易笔数,范围 1-50,默认 10。
payment_channel string
支付渠道(如 paypal)。
status string
交易状态,对本次请求的全部订单生效:
响应
- 200
OK
- application/json
- 数据结构
- 示例
数据结构
- Array [
authorized: 已授权但尚未扣款void: 已取消processing: 处理中success: 交易成功failure/error: 交易失败,数据中两个值都存在,判断失败时需同时兼容refunding: 退款中refunded: 已退款refund_failed: 退款失败expired: 已过期- ]
codestring
错误码
messagestring
错误信息
data object
transactions object[]
交易列表
idstring
交易 ID
order_idstring
该交易所属订单 ID
payment_channelstring
处理该交易的支付渠道(如 paypal)
messagestring
支付网关返回的消息,通常用于描述处理结果或错误原因
created_atstring
交易创建时间(如 2018-11-02T12:30:10Z)
testboolean
是否为测试交易
error_codestring
交易失败时支付网关返回的错误代码
amountstring
交易金额
currencystring
交易金额的货币代码(如 USD)
trade_idstring
第三方支付平台返回的交易流水号
statusstring
交易状态:
payment_namestring
该交易所使用支付方式的展示名称
payment_detail object
支付方式详情,例如银行卡信息
card_numberstring
卡号
card_monthstring
卡有效期月份
card_yearstring
卡有效期年份
card_first_namestring
持卡人名
card_last_namestring
持卡人姓
card_first_fixstring
卡号前缀(BIN,用于标识发卡机构的起始数字)
card_last_fourstring
卡号后四位
avs_result_codestring
支付网关返回的地址验证系统(AVS)结果代码
cvv_result_codestring
支付网关返回的卡安全码(CVV)校验结果代码
cursorstring
分页游标
has_moreboolean
是否有更多记录
totalint32
本次请求全部订单的交易总笔数
{
"code": "string",
"message": "string",
"data": {
"transactions": [
{
"id": "string",
"order_id": "string",
"payment_channel": "string",
"message": "string",
"created_at": "string",
"test": true,
"error_code": "string",
"amount": "string",
"currency": "string",
"trade_id": "string",
"status": "string",
"payment_name": "string",
"payment_detail": {
"card_number": "string",
"card_month": "string",
"card_year": "string",
"card_first_name": "string",
"card_last_name": "string",
"card_first_fix": "string",
"card_last_four": "string",
"avs_result_code": "string",
"cvv_result_code": "string"
}
}
],
"cursor": "string",
"has_more": true,
"total": 0
}
}