Skip to content

查询卡交易记录

GET /openapi/v1/cards/transactions
内容
请求方法GET
请求路径/openapi/v1/cards/transactions
请求类型query

请求参数:

字段类型必填默认值说明
cardIdstring卡 ID。
statusstring外部渠道原始交易状态筛选,值域可能扩展;当前已知值为 pendingsuccessfailed
currencystring交易币种,通常为 ISO 4217 三位代码;值域未封闭。
fromTimestring开始时间,ISO 8601 日期时间字符串。
toTimestring结束时间,ISO 8601 日期时间字符串。
pageinteger1页码,从 1 开始。
pageSizeinteger20每页数量,1 到 100。

响应 data

字段类型说明
itemsarray交易记录列表。
items[].idstring交易 ID。
items[].cardIdstring卡 ID。
items[].memberIdstring平台成员 ID。
items[].amountstring交易金额,外部渠道原样十进制字符串。
items[].currencystring交易币种,通常为 ISO 4217 三位代码;值域可能扩展。
items[].statusstring外部渠道原始交易状态,值域可能扩展;当前已知值为 pendingsuccessfailed
items[].occurredAtstring交易发生时间,ISO 8601 日期时间字符串。
items[].providerTransactionIdstringProvider 交易 ID。
items[].countryCodestring上游提供时的消费国家或地区代码。
items[].merchantNamestring卡组织或上游处理方提供时的商户展示名称。
items[].merchantCategoryCodestring上游提供时的四位商户类别代码(MCC)。
items[].feesarrayUCard 附加手续费订单。
items[].fees[].feeOrderNostring手续费订单号。
items[].fees[].amountstring手续费金额。
items[].fees[].currencystring手续费币种。
items[].fees[].statusstring手续费订单状态:CREATEDPROCESSINGUNKNOWNFROZENSUCCESSFAILED
items[].fees[].providerTransferIdstringProvider 划转 ID。
items[].fees[].providerStatusstringProvider 划转状态。
items[].fees[].completedTimestring手续费订单完成时间。
items[].fees[].itemsarray手续费明细。
items[].fees[].items[].feeCodestring费用编码。
items[].fees[].items[].beneficiaryTenantIdstring收益租户 ID。
items[].fees[].items[].amountstring明细金额。
items[].fees[].items[].currencystring明细币种。
pageinteger当前页码。
pageSizeinteger每页数量。
totalinteger总数。