商户接口列表 (支付结果查询)

需要授权

该接口提供所有哆啦宝用户支付订单的查询,商户可以通过该接口主动查询订单状态,完成下一步的业务逻辑。 需要调用查询接口的情况: 当商户后台、网络、服务器等出现异常,商户系统最终未接收到支付通知。

请求参数:

GET请求地址:

环境 http请求地址
正式环境 https://openapi.duolabao.cn/v1/customer/order/payresult

公共请求参数:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
customerNum String 32 商户号 10001114596730086163709
shopNum String 32 店铺编号 10001214641783052104486
orderNum String 32 订单编号 10001214641783052104486
requestNum String 32 流水号(用户系统内唯一) 2014072300007148

根据流水号GET请求示例地址:

  • GET示例
  • 1 https://openapi.duolabao.cn/v1/customer/order/payresult/{商户编号}
    /{店铺编号}/{流水号}
    2 示例值地址:
    3 https://openapi.duolabao.cn/v1/customer/order/payresult/100011145967300861
    63709/10001277938612726371591/315080832507485

根据订单号GET请求示例地址:

  • GET示例
  • 1 https://openapi.duolabao.cn/v1/customer/order/payresult/{商户编号}
    /{店铺编号}/with/{订单号}
    2 示例值地址:
    3 https://openapi.duolabao.cn/v1/customer/order/payresult/100011145
    96730086163709/10001277938612726371591/with/10021014497548368512
    422

返回参数JSON格式:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
result String 32 success表示成功,fail表示失败,error表示异常 success
customerName String 32 商户名称 哆啦宝(北京)科技有限公司
requestNum String 32 流水号(用户系统内唯一) 2014072300007148
orderNum String 32 订单编号 10021014497548368512422
source String 32 APP/IOS/ANDROID/API/SDK_C/SDK_JAVA/SDK_PHP/SCREEN(屏显)/PCCLIENT(PC客户端)/FIXCODE(固定二维码) API
bussinessType String 32 QRCODE_TRAD(二维码交易)/CUSTOMER_RECHARGE(商户充值) QRCODE_TRAD
status String 32 INIT(待支付)/SUCCESS(成功)/CANCEL(已取消)/REFUND(已退款)/REFUNDING(退款中)/REFUNDFAIL(退款失败) SUCCESS
type String 32 SALES(消费)/RECHARGE(充值) SALES
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
payRecordList amount String 15, 2 支付流水金额 100.00
payWay String 32 WX(微信支付)/WXSERVER(微信服务商支付)/YEEPAYWX(易宝微信)/WXSCAN(微信被扫)/WXSCANSERVER(微信被扫服务商)/YEEPAYWXSCAN(易宝微信被扫)/JD(京东)/RED_PACKET(补贴)/ACCOUNT(账户)/ICBC(工商银行)/BJ_CIB_ALIPAY(兴业支付宝主扫)/ BJ_CIB_ALIPAY_SCAN (兴业支付宝被扫)/CMBCALIPAY(民生支付宝主扫)/CMBCALIPAYSCAN(民生支付宝被扫)/SZ_CNCB_ALIPAY(中信支付宝主扫)/SZ_CNCB_ALIPAY_SCAN(中信支付宝被扫)/GZ_SPDB_ALIPAY(浦发支付宝主扫)/GZ_SPDB_ALIPAY_SCAN(浦发支付宝被扫) WX
saveAmount String 15, 2 支付流水优惠金额 6.66
refundTime String 32 退款时间(退款状态) 2016-06-06 12:22:00
refundAmount String 15, 2 退款金额(退款状态) 100:00
bankRequestNum String 32 银行批次号 112072300007148
bankTradeNum String 32 银行交易流水号 4002222001201707242430980917
payStatus String 32 SUCCESS(已支付)/FAIL(失败)/CANCEL(已撤销) SUCCESS
openId String 32 微信openId ojiuXuGrrejS0HwGkU8R_R2MKjY8
tradeFee String 32 交易手续费 1.00
errorCode String 32 错误码 shopNumNotExist
errorMsg String 32 错误信息 shopNum not exist

请求JSON示例:

  • JSON示例
  • 1 {
    2 "data": {
    3 "customerName": "哆啦宝(北京)科技有限公司",
    4 "requestNum": "315080832507485",
    5 "orderNum": "10021014497548368512422",
    6 "source": "FIXCODE",
    7 "bussinessType": "QRCODE_TRAD",
    8 "status": "SUCCESS",
    9 "type": "SALES",
    10 "completeTime": "2016-04-03 17:27:10",
    11 "orderAmount": "100.00",
    12 "refundTime": "2016-04-03 17:27:10",
    13 "openId": "ojiuXuLFVxR3b6aHTakdVpoXZQYQ"
    14 "payRecordList": [
    15 {
    16 "amount": "100.00",
    17 "payWay": "WX",
    18 "saveAmount": "1",
    19 "refundTime": "2016-04-03 17:27:10",
    20 "refundAmount": "100:00",
    21 "bankRequestNum": "112072300007148"
    22 "payStatus": "SUCCESS"
    23 },
    24 {
    25 "amount": "100.00",
    26 "payWay": "WX",
    27 "saveAmount": "1",
    28 "refundTime": "2016-04-03 17:27:10",
    29 "refundAmount": "100:00",
    30 "bankRequestNum": "112072300007148"
    31 "payStatus": "SUCCESS"
    32 }
    33 ]
    34 },
    34 "tradeFee": "1.00"
    35 "result": "success"
    36 }

错误响应示例:

  • 错误响应示例
  • 1 {
    2 "error": {
    3 "errorCode": "shopNumNotExist",
    4 "errorMsg":"shopNum not exist"
    5 },
    6 "result": "fail"
    7 }

异常示例:

  • 异常示例
  • 1 {
    2 "error": {
    3 "errorCode": "systemError",
    4 "errorMsg":"错误描述"
    5 },
    6 "result": "error"
    7 }