14.卡片交易明细

可通过此接口查询卡片交易明细，也可通过webhook获取。

卡片交易明细

URL

/api/v1.0/card/trades

请求参数

序号	字段	字段描述	字段类型	必填	备注
1	cardId	卡编号	String(32)	必填	开卡申请接口返回的卡编号
2	beginTime	开始时间	String	必填	开始时间 格式yyyy-MM-dd HH:mm:ss
3	endTime	结束时间	String	必填	开始时间 格式yyyy-MM-dd HH:mm:ss
4	currentPage	当前页	Number	必填	正整数
5	pageSize	分页大小	Number	必填	最大50

请求示例

{
  "custNo": "158519...017664",
  "request": {
    "beginTime": "2022-01-01",
    "cardId": "221...0000001",
    "currentPage": 1,
    "endTime": "2022-01-02",
    "pageSize": 50
  },
  "verify": "234rfre43...u763ewdft"
}

待签名字符串

"beginTime="+beginTime+"&endTime="+endTime+"&currentPage="+currentPage

响应结果

序号	字段	字段描述	字段类型	必填	备注
1	totalCount	总条数	String	必填
2	currentPage	当前页	String	必填
3	pageSize	页行数	String	必填
4	list	数据集	String	必填

响应示例

{
  "errorCode":  null,
  "errorMsg": null,
  "result": {
    "list": [{
              "recordNo": "22110...00000001",
              "cardId": "221...0000001",
              "occurTime": "2022-11-01 14:39:19",
              "transCurrency": "USD",
              "transCurrencyAmt": 10.00,
              "transType": "AUTH",
              "transStatus": "APPROVED",
              "localCurrency": "USD",
              "localCurrencyAmt": 10.00,
              "crossBoardType": null,
              "respCode": "000000",
              "respCodeDesc": "交易成功",
              "approvalCode": "000000",
              "merchantName": "xxxxx...xxxxx",
              "merchantCategoryCode": "5881",
              "commissionForRecordNo": 14231...472276b
            }
          ],
    "currentPage": 1,
    "pageSize": 50,
    "totalCount": 50
  },
  "success": true
}

Result:

序号	字段	字段描述	字段类型	必填	备注
1	recordNo	记录编号	String	必填
2	cardId	卡唯一编号	String	必填
3	occurTime	交易发生时间	String	必填
4	transCurrency	交易币种	String	/
5	transCurrencyAmt	交易币种金额	Number	必填
6	transType	交易类型	String	必填	（20221211新增） 交易类型: 见交易类型列表
7	transStatus	交易状态	String	必填	（20221211新增）交易状态: 见交易状态列表
8	localCurrency	卡本币种	String	必填
9	localCurrencyAmt	卡本币种金额	Number	必填
10	crossBoardType	跨境类型	String	/	（20221211新增）0 境内；1 境外
11	respCode	交易响应码	String	必填	见：交易响应码
12	respCodeDesc	交易响应码描述	String	必填
13	approvalCode	授权码	String	/
14	merchantName	商户名称	String	/
15	merchantCategoryCode	商户MCC	String	/	MCC，消费场景行业类型
16	commissionForRecordNo	关联transType为AUTH的recordNo字段	String	/	本字段仅在 transType="TRANS_FEE"（手续费交易）时有效，其值为所对应的原始transType="AUTH"（预授权/授权交易）的主交易记录号 (recordNo)。