支付订单查询
- 接口(建议后缀):/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": [
]
}