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

需要授权

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

请求参数:

GET请求地址:

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

公共请求参数:

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

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

  • GET示例
  • 1 https://openapi.duolabao.com/v1/agent/order/payresult/{代理商编号}/{商户编号}
    /{店铺编号}/{流水号}
    2 示例值地址:
    3 https://openapi.duolabao.com/v1/agent/order/payresult/10001114495558121971726
    /10001277938612726371591/10021010832015788527798/2014072300007148

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

  • GET示例
  • 1 https://openapi.duolabao.com/v1/agent/order/payresult/{代理商编号}/{商户编号}
    /{店铺编号}/with/{订单号}
    2 示例值地址:
    3 https://openapi.duolabao.com/v1/agent/order/payresult/10001114495558121971726
    /10001114596730086163709/10001277938612726371591/with
    /10021014497548368512422

返回参数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
openId String 32 微信openId ojiuXuGrrejS0HwGkU8R_R2MKjY8
tradeFee String 32 交易手续费 1.00
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
payStatus String 32 SUCCESS(已支付)/FAIL(失败)/CANCEL(已撤销) SUCCESS
bankRequestNum String 32 银行批次号 112072300007148
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 "payRecordList": [
    14 {
    15 "amount": "100.00",
    16 "payWay": "WX",
    17 "saveAmount": "1",
    18 "refundTime": "2016-04-03 17:27:10",
    19 "refundAmount": "100:00",
    20 "bankRequestNum": "112072300007148"
    21 "payStatus": "SUCCESS"
    22 },
    23 {
    24 "amount": "100.00",
    25 "payWay": "WX",
    26 "saveAmount": "1",
    27 "refundTime": "2016-04-03 17:27:10",
    28 "refundAmount": "100:00",
    29 "bankRequestNum": "112072300007148"
    30 "payStatus": "SUCCESS"
    31 }
    32 ]
    33 },
    34 "openId": "ojiuXuLFVxR3b6aHTakdVpoXZQYQ"
    35 "tradeFee": "1.00"
    36 "result": "success"
    37 }

错误响应示例:

  • 错误响应示例
  • 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 }