请求URL

POST {域名}/api/vas/trans/v3/query

请求参数

加密数据dataContent

序号 域名 变量名 必填 长度 备注
1. 卡片类型 cardType M String 0:常规卡 1:共享卡
2. 卡唯一编号 cardId O Number 选填，卡唯一id
3. 起始时间 beginTime M String 格式yyyy-MM-dd HH:mm:ss
4. 结束时间 endTime M String 格式yyyy-MM-dd HH:mm:ss

注：起始和结束时间最长间隔45天
5. 时间类型 timeType M int 0:根据交易时间查询
1:根据创建时间查询
6. 交易类型 commonTransType O int 1:消费 2:冲正 3:退款 4:清算差额 5:冲正后请款 7:强制清算
7. 交易状态 commonTransStatus O int 1:批准 2:拒绝 3:已清算
8. 当前页数 currentPage M int 正整数
9. 分页大小 pageSize M int 最大50
10. 要查询的用户号/子用户号 queryUserNo O Number 要查询的用户号/子用户号，为空时表示查询名下所有母+子交易明细

dataContent示例

{
  "cardId": "2408080906000001109",
  "cardType": "1",
  "createDateEnd": "2024-08-28",
  "createDateStart": "2024-05-18",
  "currentPage": "1",
  "pageSize": "20",
  "tradeType": ""
}

响应参数

结果信息result

序号 域名 变量名 必填 长度 备注
1. 总条数 totalCount M Number
2. 当前页数 currentPage M Number
3. 分页大小 pageSize M Number
4. 总页数 totalPages M Number
5. 交易明细 list O List<Object>

交易明细 Object:

序号 域名 变量名 必填 长度 备注
1. 记录编号 recordNo String M 记录编号
2. 原记录编号 originRecordNo String O 原记录编号
3. 卡唯一编号 cardId String M 卡id
4. 交易发生时间 transTime String M 交易发生时间
5. 交易币种 transCurrency String M 交易币种
6. 交易币种金额 transCurrencyAmt Number M 交易币种金额
7. 卡本币种 localCurrency String M 卡币种
8. 卡本币种金额 localCurrencyAmt Number M 卡本币种交易金额
9. 授权码 approvalCode String O 授权码
10. 商户名称 merchantName String M 商户名称
11. 商户MCC merchantCategoryCode String O 商户MCC
12. 商户国家 merchantCountryCode String O 商户国家
13. 跨境类型 crossBoardType String O 0：境内 1：境外
14. 交易类型 commonTransType int M 1:消费 2:冲正 3:退款 4:清算差额 5:冲正后请款 7:强制清算
15. 交易状态 commonTransStatus int M 1:批准 2:拒绝 3:已清算
16. 交易响应码 commonRespCode String M 详见附录：交易响应码
17. 交易响应码描述 commonRespCodeDesc String M 详见附录：交易响应码描述
18. 资金类型 fundsType int M 0:常规卡 1:共享卡 2:账户
19. 资金方向 fundsDirection int M 0:扣款 1:退款
20. 子用户号 subUserNo String O 子用户号（主用户不返回）
21. 子用户名 subUserName String O 子用户名（主用户不返回）
22. 清算金额 settleAmount Number O 清算金额(commonTransType=1或7,且commonTransStatus=3时才有值)
23. 清算时间 settleTime String O commonTransStatus=3时有值

👉常见流程:

  • 消费(拒绝)—>结束
  • 消费(批准)—>消费(已清算·有settleAmount)[无清算差额]—>结束
  • 消费(批准)—>消费(已清算·有settleAmount)[有清算差额]—>清算差额(已清算)—>结束
  • 退款(已清算)—>结束(退款一般发生在原交易清算之后,但大多数关联不到原交易单号)
  • 消费(批准)—>冲正(批准)—>结束(已冲正的交易,原消费交易的状态不会再变为已清算)
  • 消费(批准)—>冲正(批准)—>消费(已清算·有settleAmount)—>冲正后请款(已清算)—>结束
  • 强制清算(已清算·有settleAmount)—->结束(强制清算是没有授权的直接清算的交易)

result示例

{
  "currentPage": 1,
  "list": [
    {
      "cardId": "2505201621000006084",
      "commonRespCode": "000000",
      "commonRespCodeDesc": "交易成功",
      "commonTransStatus": 3,
      "commonTransType": 1,
      "crossBoardType": "1",
      "fundsDirection": 0,
      "fundsType": 0,
      "localCurrency": "USD",
      "localCurrencyAmt": 99,
      "merchantCategoryCode": "5816",
      "merchantCountryCode": "JPN",
      "merchantName": "test dis 2",
      "originRecordNo": "2505201622001039417",
      "recordNo": "2505201622001039417",
      "settleAmount": 98,
      "settleTime": "2025-05-20 16:25:01",
      "transCurrency": "USD",
      "transCurrencyAmt": 99,
      "transTime": "2025-05-20 16:22:55"
    },
    {
      "cardId": "2505201614000006083",
      "commonRespCode": "000000",
      "commonRespCodeDesc": "交易成功",
      "commonTransStatus": 3,
      "commonTransType": 4,
      "crossBoardType": "1",
      "fundsDirection": 0,
      "fundsType": 0,
      "localCurrency": "USD",
      "localCurrencyAmt": 98,
      "merchantCategoryCode": "5816",
      "merchantCountryCode": "JPN",
      "merchantName": "test dis 2",
      "originRecordNo": "2505201616001039405",
      "recordNo": "2505201618001039410",
      "settleTime": "2025-05-20 16:18:14",
      "transCurrency": "USD",
      "transCurrencyAmt": 98,
      "transTime": "2025-05-20 16:18:14"
    }
  ],
  "pageSize": 20,
  "totalCount": 157,
  "totalPages": 8
}