订单列表
POST
/{{version}}/openApi/card/order/orderList
使用场景
获取卡订单列表。
请求参数
| 字段 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
| customer_id | long | 是 | 客户id |
| app_id | long | 是 | 应用id |
| key | string | 是 | 授权key |
| order_id | string | 否 | 订单id |
| out_order_id | string | 否 | 外部订单id |
| card_type | int | 否 | 卡类型 1:实体卡 2:虚拟卡 3:虚拟固定面额卡 |
| order_type | int | 否 | 订单类型 1:开卡 2:充值 |
| status | int | 否 | 状态 0:处理中; 1:已完成; 2:已退款; 3:异常; 4:审核中，不传status则不限制状态 |
| begin_time | datetime | 否 | 开始时间 |
| end_time | datetime | 否 | 结束时间 |
| page_no | int | 是 | 页码 |
| page_size | int | 是 | 每页记录数 |
{
"customer_id": 10000011,
"app_id": 100001,
"key": "ae9ae3f5ad284ef4836de18aa3d41c47",
"page_no": 1,
"page_size": 10
}
响应内容
| 字段 | 类型 | 是否必传 | 描述 |
|---|---|---|---|
| total | int | 是 | 总数 |
| page_no | int | 是 | 当前页码 |
| page_size | int | 是 | 当前每页记录数 |
| order_list | array[object] | 是 | 订单数组 |
| order_list.order_id | string | 是 | 订单 id |
| order_list.bin_id | string | 是 | bin id |
| order_list.holder_id | string | 是 | 持卡人 id |
| order_list.out_order_id | string | 是 | 外部交易订单 id |
| order_list.card_type | int | 是 | 卡类型 1:实体卡 2:虚拟卡 3:虚拟固定面额卡 |
| order_list.order_type | int | 是 | 订单类型 1:开卡 2:充值 |
| order_list.amount | float | 是 | 订单金额，单位：元 |
| order_list.fee | float | 是 | 手续费，单位：元 |
| order_list.currency | string | 是 | 币种 |
| order_list.card_id | string | 是 | 卡 id |
| order_list.status | int | 是 | 状态 0:处理中; 1:已完成; 2:已退款; 3:异常; 4:审核中 |
| order_list.track_code | string | 是 | 快递单号 |
| order_list.track_supplier | datetime | 是 | 快递服务商 |
| order_list.track_at | datetime | 是 | 发货时间 |
| order_list.complete_at | datetime | 是 | 完成时间 |
| order_list.create_at | datetime | 是 | 创建时间 |
{
"code": 0,
"message": "success",
"data": {
"total": 2,
"page_no": 1,
"page_size": 10,
"order_list": [
{
"order_id": "ord_XrRyEMwf",
"bin_id": "cpi_6530de6a2f1c7",
"holder_id": "",
"out_order_id": "out_10002000003",
"card_type": 2,
"order_type": 2,
"amount": 20,
"fee": 0.4,
"currency": "USD",
"card_id": "cid_teQnwAjsUcgULfpX",
"status": 1,
"track_code": "",
"track_supplier": "",
"track_at": "",
"complete_at": "2025-02-19 05:38:59",
"create_at": "2025-02-19 05:38:59"
},
{
"order_id": "ord_HW5eAc6L",
"bin_id": "cpi_6530de6a2f1c7",
"holder_id": "",
"out_order_id": "out_10001000000",
"card_type": 2,
"order_type": 1,
"amount": 100,
"fee": 12,
"currency": "USD",
"card_id": "cid_fBWWMWm8aUUYy3sd",
"status": 1,
"track_code": "",
"track_supplier": "",
"track_at": "",
"complete_at": "2025-02-19 05:08:43",
"create_at": "2025-02-19 05:08:43"
}
]
}
}
请求参数
Body 参数application/json
请求示例代码
返回响应
修改于 2026-03-19 06:16:48