15.卡片账单明细

可通过此接口查询卡片账单信息，账单信息包括已清算的消费、退款。

卡片账单明细

URL

/api/v1.0/card/settlements

请求参数

序号	字段	字段描述	字段类型	必填	备注
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": 20
  },
  "verify": "234rfre43...u763ewdft"
  }

待签名字符串

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

响应结果

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

响应示例

{
  "errorCode":  null,
  "errorMsg": null,
  "result": {
    "list": [{
              "approvalCode": "000000",
              "billCurrency": "USD",
              "billCurrencyAmt": 100.00,
              "cardId": "221...0000001",
              "isCredit": "1",
              "merchantName": "xxxxxxxxxxxxxxxx",
              "recordNo": "2212...0000627",
              "settleDate": "2022-11-01",
              "transCurrency": "USD",
              "transCurrencyAmt": 100.00
            }],
    "currentPage": 1,
    "pageSize": 50,
    "totalCount": 500
  },
  "success": true
}

Result:

字段	字段描述	字段类型	必填	备注
recordNo	记录编号	String	必填
cardId	卡唯一编号	String	必填
settleDate	账单日期	String	必填
transCurrency	交易币种	String	必填
transCurrencyAmt	交易金额	Number	必填
billCurrency	账单币种	String	必填
billCurrencyAmt	账单金额	Number	必填
approvalCode	授权码	String	/
isCredit	收付标识	String	必填	0:付(消费) 1:收(退款) 2：交易处理费
merchantName	商户名称	String	必填