请求URL
POST {域名}/api/vas/trans/v2/query
请求参数
加密数据dataContent
| 序号 |
域名 |
变量名 |
必填 |
长度 |
备注 |
| 01. |
卡唯一编号 |
cardId |
O |
String |
选填,卡唯一id |
| 02. |
交易类型 |
tradeType |
M |
String |
选填,AUTH,SETTLEMENT |
| 03. |
交易起始日期 |
beginTime |
C |
String |
格式yyyy-MM-dd(交易日期和交易创建日期不能同时为空) |
| 04. |
交易结束日期 |
endTime |
C |
String |
格式yyyy-MM-dd(交易日期和交易创建日期不能同时为空) |
| 05. |
交易创建日期开始 |
createDateStart |
C |
String |
格式yyyy-MM-dd(交易日期和交易创建日期不能同时为空) |
| 06. |
交易创建日期结束 |
createDateEnd |
C |
String |
格式yyyy-MM-dd(交易日期和交易创建日期不能同时为空) |
| 07. |
当前页数 |
currentPage |
M |
int |
正整数 |
| 08. |
分页大小 |
pageSize |
M |
int |
最大50 |
| 09. |
卡片类型 |
cardType |
M |
String |
1:常规卡 2:共享卡 |
| 10. |
要查询的用户号/子用户号 |
queryUserNo |
O |
Number |
要查询的用户号/子用户号,为空时表示查询名下所有母+子交易明细 |
dataContent示例
{
"cardId": "2408080906000001109",
"cardType": "1",
"createDateEnd": "2024-08-28",
"createDateStart": "2024-05-18",
"currentPage": "1",
"pageSize": "20",
"tradeType": ""
}
响应参数
结果信息result
| 序号 |
域名 |
变量名 |
必填 |
长度 |
备注 |
| 01. |
授权交易 |
authInfoRespDto |
O |
authInfoRespDto |
tradeType=AUTH时返回 |
| 02. |
清算交易 |
settlementInfoRespDto |
O |
settlementInfoRespDto |
tradeType=SETTLEMENT时返回 |
authInfoRespDto:
| 序号 |
域名 |
变量名 |
必填 |
长度 |
备注 |
| 01. |
授权交易总条数 |
totalCount |
String |
M |
|
| 02. |
当前页数 |
currentPage |
String |
M |
|
| 03. |
分页大小 |
pageSize |
String |
M |
|
| 04. |
授权交易记录 |
authInfos |
List<AuthInfo> |
O |
|
AuthInfo:
| 序号 |
域名 |
变量名 |
必填 |
长度 |
备注 |
| 01. |
记录编号 |
recordNo |
String |
M |
记录编号 |
| 02. |
卡唯一编号 |
cardId |
String |
M |
卡id |
| 03. |
交易发生时间 |
occurTime |
String |
M |
交易发生时间 |
| 04. |
交易币种 |
transCurrency |
String |
O |
交易币种 |
| 05. |
交易币种金额 |
transCurrencyAmt |
Number |
M |
交易币种金额 |
| 06. |
卡本币种 |
localCurrency |
String |
M |
卡币种 |
| 07. |
卡本币种金额 |
localCurrencyAmt |
Number |
M |
卡本币种交易金额 |
| 08. |
交易响应码 |
respCode |
String |
M |
详见附录:交易响应码 |
| 09. |
交易响应码描述 |
respCodeDesc |
String |
M |
详见附录:交易响应码 |
| 10. |
授权码 |
approvalCode |
String |
O |
授权码 |
| 11. |
交易拒绝原因 |
declineReason |
String |
O |
交易拒绝原因【待废弃】 |
| 12. |
交易类型 |
messageType |
String |
M |
交易类型【待废弃】 |
| 13. |
交易类型描述 |
messageTypeDesc |
String |
M |
交易类型描述【待废弃】 |
| 14. |
商户名称 |
merchantName |
String |
M |
商户名称 |
| 15. |
商户MCC |
merchantCategoryCode |
String |
O |
商户MCC |
| 16. |
跨境类型 |
crossBoardType |
String |
O |
0:境内 1:境外 |
| 17. |
交易类型 |
transType |
String |
M |
详见附录:交易类型 |
| 18. |
交易状态 |
transStatus |
String |
M |
详见附录:交易状态 |
| 19. |
原记录编号 |
originRecordNo |
String |
O |
原记录编号 |
| 20. |
子用户号 |
subUserNo |
String |
O |
子用户号(主用户不返回) |
| 21. |
子用户名 |
subUserName |
String |
O |
子用户名(主用户不返回) |
settlementInfoRespDto:
| 序号 |
域名 |
变量名 |
必填 |
长度 |
备注 |
| 01. |
清算交易总条数 |
totalCount |
String |
M |
|
| 02. |
当前页数 |
currentPage |
String |
M |
|
| 03. |
分页大小 |
pageSize |
String |
M |
|
| 04. |
清算交易记录 |
settlementInfos |
List<SettlementInfo> |
O |
|
SettlementInfo:
| 序号 |
域名 |
变量名 |
必填 |
长度 |
备注 |
| 01. |
记录编号 |
recordNo |
String |
M |
记录编号 |
| 02. |
卡唯一编号 |
cardId |
String |
M |
卡id |
| 03. |
账单日期 |
settleDate |
String |
M |
账单日期 |
| 04. |
交易币种 |
transCurrency |
String |
M |
交易币种 |
| 05. |
交易金额 |
transCurrencyAmt |
Number |
M |
交易金额 |
| 06. |
账单币种 |
billCurrency |
String |
M |
账单币种 |
| 07. |
账单金额 |
billCurrencyAmt |
Number |
M |
账单金额 |
| 08. |
授权码 |
approvalCode |
String |
O |
授权码 |
| 09. |
收付标识 |
isCredit |
String |
M |
1:收(退款) 0:付(消费) |
| 10. |
商户名称 |
merchantName |
String |
O |
商户名称 |
| 11. |
原记录编号 |
originRecordNo |
String |
O |
原记录编号 |
| 12. |
子用户号 |
subUserNo |
String |
O |
子用户号(主用户不返回) |
| 13. |
子用户名 |
subUserName |
String |
O |
子用户名(主用户不返回) |
result示例
{
"authInfoRespDto": {
"authInfos": [
{
"cardId": "2408080906000001109",
"crossBoardType": "1",
"declineReason": "",
"localCurrency": "USD",
"localCurrencyAmt": 20,
"merchantCategoryCode": "5816",
"merchantName": "test dis 2",
"occurTime": "2024-08-08 09:07:08",
"recordNo": "2408080907000778326",
"respCode": "000000",
"respCodeDesc": "交易成功",
"transCurrency": "USD",
"transCurrencyAmt": 20,
"transStatus": "APPROVED",
"transType": "AUTH"
}
],
"currentPage": 1,
"pageSize": 20,
"totalCount": 1
},
"settlementInfoRespDto": {
"currentPage": 1,
"pageSize": 20,
"settlementInfos": [
{
"billCurrency": "USD",
"billCurrencyAmt": -20,
"cardId": "2408080906000001109",
"isCredit": "1",
"merchantName": "test dis 2",
"originRecordNo": "2408080907000778326",
"recordNo": "2408080923000778736",
"settleDate": "2024-08-08",
"transCurrency": "USD",
"transCurrencyAmt": -20
}
],
"totalCount": 1
}
}