资源接口列表 (商家交易流水查询)

需要授权

使用oauth2协议的accessToken和customerOpenId获取商家订单流水信息

请求参数:

签名:

签名信息 签名类型
是否签名

POST请求地址:

环境 https请求地址
正式环境 https://openrealm.duolabao.cn/v1/customer/order/batch/query

公共请求参数:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
customerOpenId String 32 商家open_id 11084830284398
startTime String 32 必填,日期格式错误或者不填日期,默认查今天,最大时间间隔不超过7天 2016-07-06 15:19:08
endTime String 32 必填,日期格式错误或者不填日期,默认查今天,最大时间间隔不超过7天 2016-07-012 15:19:08
pageNum String 32 页码从1开始,每页1000条记录

请求头:

请求头 示例值 描述
timestamp 102202020202 时间戳
token 44B74C2B0BDA30F8C949FC9F20FA5CB123E179E7 根据密钥和算法生成的结果
accessToken 3rdsfaij43209dfaojf 从授权系统获得的accessToken值
accessKey fe02aa7e8f3249fe86c93774b7103d9945f80 用户的公钥

请求示例:

  • 请求示例
  • 1 {
    2 "customerOpenid": "6c20341b522bbd690764dc05d0d73789",
    3 "startTime": "2016-07-06 15:19:08",
    4 "endTime": "2016-08-05 15:19:08",
    5 "pageNum": "1"
    6 }

返回参数JSON格式:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
customerNum String 32 商户编号 11214641783052
orderNum String 32 订单编号 10001214641783052104486
completeTime String 32 订单完成时间 2016-04-03 17:27:10
orderAmount String 15,2 订单金额 100.00
refundTime String 32 时间格式2016-6-24 21:42:40 2016-6-24 21:42:40
status String 32 INIT(待支付)/SUCCESS(成功)/CANCEL(已取消)/REFUND(已退款)/REFUNDING(退款中)/REFUNDFAIL(退款失败) SUCCESS
result String 32 SUCCESS表示成功,FAIL表示失败 success
errorCode String 32 错误码 customerNotExist 、orderNotExist
errorMsg String 32 错误信息 success

响应示例:

  • 响应示例
  • 1 {
    2 "data": {
    3 "orderList": [
    4 {
    5 "customerNum": "10021014679680366408447"
    6 "completeTime": "2016-07-12 15:43:13",
    7 "orderAmount": "0.01",
    8 "orderNum": "10021014683093339018474",
    9 "refundTime": "2016-07-12 15:43:13",
    10 "status": "REFUND"
    11 },
    12 {
    13 "customerNum": "10021014679680366408447",
    14 "completeTime": "2016-07-08 16:54:08",
    15 "orderAmount": "0.01",
    16 "orderNum": "10021014679680366408447",
    17 "requestNum": "1467968309017215",
    18 "status": "SUCCESS"
    19 },
    20 {
    21 "customerNum": "10021014679680366408447",
    22 "completeTime": "2016-07-08 16:54:08",
    23 "orderAmount": "0.01",
    24 "orderNum": "10021014679487197128438",
    25 "requestNum": "1467948989004654",
    26 "status": "INIT"
    27 },
    28 ]
    29 "result": "success"
    14 }

错误响应示例:

  • 响应示例
  • 响应示例
  • 1 {
    2 "error": {
    3 "errorCode": "customerNumNotExist",
    4 "errorMsg": "customerNum not exist"
    5 },
    6 "result": "fail"
    7 }
  • 1 {
    2 "error": {
    3 errorCode": "systemError",
    4 "errorMsg":"错误描述"
    5 },
    6 "result": "error"
    7 }

错误码解释:

错误码 错误描述 解决方案
paramsError requestNum must be specified 参数不正确,请确认参数
outTimeRange out of time range 查询时间超出范围
agentInvalid agent invalid 代理商无效
customerInvalid customer invalid 商户无效