查询交易记录
简要描述:
查询指定卡号的交易记录。单次查询时间范围最大为 3 个月。
请求URL:${baseUrl}/op/card/L/transaction
请求方式:
POST
请求头部:
Content-Type: application/json
请求参数
| 参数名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| cardNumber | 是 | string | 卡号 |
| pageToken | 是 | string | 页码 |
| pageSize | 是 | string | 数量 |
| creationTimeFrom | 是 | string | 起始时间,格式yyyy-MM-dd |
| creationTimeTo | 是 | string | 结束时间,格式yyyy-MM-dd |
返回示例
{
"data": {
"currentPage": 1,
"pageSize": 2,
"totalRecords": 3,
"transactions": [
{
"cardId": "2408032111001269724",
"crossBoardType": "1",
"localCurrency": "USD",
"localCurrencyAmt": "",
"occurTime": 1722682107000,
"platformType": "消费",
"recordNo": "2408031848060073804",
"respCode": "000000",
"respCodeDesc": "交易成功",
"transCurrency": "CNY",
"transCurrencyAmt": "38.48",
"transStatus": "APPROVED",
"transType": "AUTH"
},
{
"cardId": "2408032111001269724",
"crossBoardType": "1",
"localCurrency": "USD",
"localCurrencyAmt": "",
"occurTime": 1722682107000,
"platformType": "消费",
"recordNo": "2408031848060073804",
"respCode": "000000",
"respCodeDesc": "交易成功",
"transCurrency": "CNY",
"transCurrencyAmt": "38.48",
"transStatus": "APPROVED",
"transType": "AUTH"
}
]
},
"msg": "操作成功",
"status": 200,
"success": true
}
返回参数说明
| 参数名称 | 示例 | 参数说明 | 类型 |
|---|---|---|---|
| data | json | 响应数据,见下方 data 字段 | object |
| msg | 操作成功 | 响应消息 | string |
| status | 200 | 响应码 | int |
| success | true | 是否成功:true-成功,false-失败 | boolean |
data 字段说明(transactions 列表项)
| 参数名称 | 示例 | 参数说明 | 类型 |
|---|---|---|---|
| recordNo | 245346345345 | 流水号 | string |
| occurTime | 1722682107000 | 交易发生时间(时间戳) | long |
| transCurrency | CNY | 交易币种 | string |
| transCurrencyAmt | 38.48 | 交易币种金额 | string |
| localCurrency | USD | 卡币种 | string |
| localCurrencyAmt | 38.48 | 卡本币种交易金额 | string |
| respCode | 000000 | 交易响应码 | string |
| respCodeDesc | 交易成功 | 交易响应码描述 | string |
| crossBoardType | 1 | 跨境类型:0-境内 1-境外 | string |
| transType | AUTH | 交易类型(AUTH-消费 REFUND-退款 FEE-手续费 TOP UP-增值 REVERSAL-冲正) | string |
| transStatus | APPROVED | 交易状态(APPROVED-批准 DECLINED-拒绝) | string |
| platformType | 消费 | 描述 | string |
| merchantName | WEIXIN*Meituan | 交易商户信息 | string |
| merchantCategoryCode | 5999 | 商户类型 | string |
| approvalCode | VWAJ0R | 批准代码 | string |