Appearance
查询卡交易记录
GET/openapi/v1/cards/transactions| 项 | 内容 |
|---|---|
| 请求方法 | GET |
| 请求路径 | /openapi/v1/cards/transactions |
| 请求类型 | query |
请求参数:
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
cardId | string | 是 | 无 | 卡 ID。 |
status | string | 否 | 无 | 外部渠道原始交易状态筛选,值域可能扩展;当前已知值为 pending、success、failed。 |
currency | string | 否 | 无 | 交易币种,通常为 ISO 4217 三位代码;值域未封闭。 |
fromTime | string | 否 | 无 | 开始时间,ISO 8601 日期时间字符串。 |
toTime | string | 否 | 无 | 结束时间,ISO 8601 日期时间字符串。 |
page | integer | 否 | 1 | 页码,从 1 开始。 |
pageSize | integer | 否 | 20 | 每页数量,1 到 100。 |
响应 data:
| 字段 | 类型 | 说明 |
|---|---|---|
items | array | 交易记录列表。 |
items[].id | string | 交易 ID。 |
items[].cardId | string | 卡 ID。 |
items[].memberId | string | 平台成员 ID。 |
items[].amount | string | 交易金额,外部渠道原样十进制字符串。 |
items[].currency | string | 交易币种,通常为 ISO 4217 三位代码;值域可能扩展。 |
items[].status | string | 外部渠道原始交易状态,值域可能扩展;当前已知值为 pending、success、failed。 |
items[].occurredAt | string | 交易发生时间,ISO 8601 日期时间字符串。 |
items[].providerTransactionId | string | Provider 交易 ID。 |
items[].countryCode | string | 上游提供时的消费国家或地区代码。 |
items[].merchantName | string | 卡组织或上游处理方提供时的商户展示名称。 |
items[].merchantCategoryCode | string | 上游提供时的四位商户类别代码(MCC)。 |
items[].fees | array | UCard 附加手续费订单。 |
items[].fees[].feeOrderNo | string | 手续费订单号。 |
items[].fees[].amount | string | 手续费金额。 |
items[].fees[].currency | string | 手续费币种。 |
items[].fees[].status | string | 手续费订单状态:CREATED、PROCESSING、UNKNOWN、FROZEN、SUCCESS 或 FAILED。 |
items[].fees[].providerTransferId | string | Provider 划转 ID。 |
items[].fees[].providerStatus | string | Provider 划转状态。 |
items[].fees[].completedTime | string | 手续费订单完成时间。 |
items[].fees[].items | array | 手续费明细。 |
items[].fees[].items[].feeCode | string | 费用编码。 |
items[].fees[].items[].beneficiaryTenantId | string | 收益租户 ID。 |
items[].fees[].items[].amount | string | 明细金额。 |
items[].fees[].items[].currency | string | 明细币种。 |
page | integer | 当前页码。 |
pageSize | integer | 每页数量。 |
total | integer | 总数。 |
