支付订单查询
- 接口(建议后缀):/order/pay/queryOrder
- Method:POST
- 数据格式:Json
- 调用方:每刻
- 接口说明:每刻将通过该接口,获取特定范围的支付流水数据
请求参数
字段 |
类型 |
必填 |
描述 |
corpCode |
String |
Y |
企业唯一标识,为企业在银行的唯一标识,如企业编码等 |
cardNo |
String |
[1] |
卡号 |
startDate |
String |
[2] |
开始日期(yyyy-MM-dd) [3] |
endDate |
String |
[2] |
结束日期(yyyy-MM-dd) [3] |
pageNo |
int |
Y |
第几页(从第1页开始) |
pageSize |
int |
Y |
每页容量(最大为 100) |
[warning] 注意:
[1] 非必填参数,若有传卡号,则只获取该卡流水。
[2] 没有开始与结束日期,默认结束日期为请求日期;只有开始时间,表示从开始日期到调用日期的订单;只有结束日期,开始日期为结束日期的前一个月。
[3] 默认开始时间为0:00,默认结束时间为23:59。
响应结构
字段 |
类型 |
必填 |
描述 |
success |
bool |
Y |
请求是否成功 |
errorMessage |
String |
N |
失败信息(当 success 为 false 时,调用详情为必填, 表示失败信息) |
data |
List<PayOrder> |
N |
失败信息(当 success 为 false 时,调用详情为必填, 表示失败信息) |
hasNextPage |
bool |
N |
是否有下一页 |
[warning] 关于请求分页如何结束:
hasNextPage = false 标志着分页结束,success 仅表示请求是否成功。
PayOrder
字段 |
类型 |
必填 |
描述 |
sequenceNo |
String |
Y |
流水号-订单在第三方的唯一编码 |
corpCode |
String |
Y |
企业在第三方的唯一编码 |
cardNo |
String |
Y |
卡号 |
cardHolderName |
String |
N |
持卡人姓名 |
cardHolderMobile |
String |
N |
持卡人手机号 |
cardHolderEId |
String |
N |
持卡人工号 |
transactionAt |
String |
Y |
交易时间(yyyy-MM-dd HH:mm:ss) |
transactionCurrency |
String |
Y |
交易币种, 如 USD |
transactionAmount |
BigDecimal |
Y |
交易金额 |
postedDate |
String |
Y |
入账日期(yyyy-MM-dd) |
postedCurrency |
String |
Y |
入账币种, 如 CNY |
postedAmount |
BigDecimal |
Y |
入账金额 |
exchangeDate |
String |
N |
外币折算日(若有外币换算则需要,yyyy-MM-dd) |
payType |
String |
Y |
承债方式,PERSONAL_PAY(个人承债), CORP_ACCOUNT_PAY(企业承债) |
debitCreditFlag |
String |
Y |
借贷标志, CONSUME(消费),REPAYMENT(还款) ,REFUND(退货) |
merchantType |
String |
N |
商户类型 |
merchantName |
String |
Y |
商户名称 |
consumeCity |
City |
N |
消费城市 |
remark |
String |
N |
订单备注 |
City
字段 |
类型 |
必填 |
描述 |
name |
String |
N |
城市名称,如杭州市 |
adminDivCode |
String |
N |
行政区划编码,如杭州330100 |
商户类型
code |
定义 |
FLIGHT |
航空类 |
HOTEL |
宾馆类 |
TRAIN |
火车类 |
CAR |
客运类、汽车交易类、加油类 |
MEAL |
餐饮类 |
GOLD |
珠宝、黄金、工艺类 |
REAL_ESTATE |
房地产类 |
SOCIETY |
政府服务类、慈善与社会服务类 |
MEDICAL |
医疗、公立医院类 |
ENTERTAIN |
娱乐类 |
MARKET |
超市类、商城类 |
OTHERS |
其他一般类商户 |
示例
[warning] 重要:
示例维护并非和文档字段维护一样频繁,如果遇到示例和文档不一致,请以文档为准
请求头:
{
"tokenId": "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJtYXljdXJfand0X2Rldl9pZCIsInN1YiI6IlBGMjAwNjIwMTI1NU5GTk8iLCJpYXQiOjE2MDQ2MzA5NjYsImF1ZCI6IlBMQVRGT1JNIiwiZXhwIjoxNjA0NjM0NTY2LCJwcm9kdWN0TGluZSI6IkRBVEFfSFVCIn0.AyNIwPtGUXxFMuHO8Bx-4XeXNyWYRcot40MfsL1swr4"
}
请求示例:
{
"corpCode" : "MAYCUR",
"cardNo" : "622202122220292929",
"startDate" : "2022-03-01",
"endDate" : "2022-03-02",
"pageNo" : 1,
"pageSize" : 20
}
响应示例:
{
"success": true,
"errorMessage": null,
"data": [
]
}