商户接口列表 (支付结果查询)
需要授权
该接口提供所有哆啦宝用户支付订单的查询,商户可以通过该接口主动查询订单状态,完成下一步的业务逻辑。 需要调用查询接口的情况:
当商户后台、网络、服务器等出现异常,商户系统最终未接收到支付通知。
请求参数:
GET请求地址:
环境 |
http请求地址 |
正式环境 |
https://openapi.duolabao.com/v1/customer/order/payresult |
公共请求参数:
参数名称 |
参数类型 |
是否必填 |
最大长度 |
参数说明 |
示例值 |
customerNum |
String |
是 |
32 |
商户号 |
10001114596730086163709 |
shopNum |
String |
是 |
32 |
店铺编号 |
10001214641783052104486 |
orderNum |
String |
否 |
32 |
订单编号 |
10001214641783052104486 |
requestNum |
String |
是 |
32 |
流水号(用户系统内唯一) |
2014072300007148 |
tradeNum |
String |
否 |
32 |
银行交易流水号 |
4009632001201709019416797992 |
refundRequestNum |
String |
否 |
32 |
退款请求流水号 |
10081115470042926650008 |
根据流水号GET请求示例地址:
-
1
|
https://openapi.duolabao.com/v1/customer/order/payresult/{商户编号}
|
|
/{店铺编号}/{流水号}
|
2
|
示例值地址:
|
3
|
https://openapi.duolabao.com/v1/customer/order/payresult/100011145967300861
|
|
63709/10001277938612726371591/315080832507485
|
根据订单号GET请求示例地址:
-
1
|
https://openapi.duolabao.com/v1/customer/order/payresult/{商户编号}
|
|
/{店铺编号}/with/{订单号}
|
2
|
示例值地址:
|
3
|
https://openapi.duolabao.com/v1/customer/order/payresult/100011145
|
|
96730086163709/10001277938612726371591/with/10021014497548368512
|
|
422
|
根据银行交易流水号GET请求示例地址:
-
1
|
https://openapi.duolabao.com/v1/customer/order/payresult/{商户编号}
|
|
/{店铺编号}/apply/{银行交易流水号}
|
2
|
示例值地址:
|
3
|
https://openapi.duolabao.com/v1/customer/order/payresult/100011145967300861
|
|
63709/10001277938612726371591/apply/
4009632001201709019416797992
|
|
422
|
根据退款请求流水号GET请求示例地址:
-
1
|
https://openapi.duolabao.com/v1/customer/order/payresult/{customerNum}/
|
|
{shopNum}/{requestNum}/use/{refundRequestNum}
|
2
|
示例值地址:
|
3
|
https://openapi.duolabao.com/v1/customer/order/payresult/100011145967300861
|
|
63709/315080832507485/10001277938612726371591/use/
4009632001201709019416797992
|
|
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 |
refundRequestNum |
String |
否 |
32 |
退款请求流水号 |
10081115470042926650008 |
openId |
String |
是 |
32 |
微信openId |
ojiuXuGrrejS0HwGkU8R_R2MKjY8 |
tradeFee |
String |
是 |
32 |
交易手续费 |
1.00 |
errorCode |
String |
否 |
32 |
错误码 |
shopNumNotExist |
isPaying |
boolean |
否 |
|
正在支付 |
true |
remark |
String |
否 |
32 |
备注 |
102 银行卡可用余额不足(如信用卡则为可透支额度不足),请核实后再试 |
errorMsg |
String |
否 |
32 |
错误信息 |
shopNum not exist |
请求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
|
"refundRequestNum": "10081115470042926650008"
|
24
|
},
|
25
|
{
|
26
|
"amount": "100.00",
|
27
|
"payWay": "WX",
|
28
|
"saveAmount": "1",
|
29
|
"refundTime": "2016-04-03 17:27:10",
|
30
|
"refundAmount": "100:00",
|
31
|
"bankRequestNum": "112072300007148"
|
32
|
"payStatus": "SUCCESS"
|
33
|
"refundRequestNum": "10081115470042926650008"
|
34
|
}
|
35
|
]
|
36
|
},
|
37
|
"tradeFee": "1.00"
|
38
|
"isPaying": "true"
|
39
|
"remark": "102 银行卡可用余额不足(如信用卡则为可透支额度不足),请核实后再试"
|
40
|
"result": "success"
|
41
|
}
|
错误响应示例:
-
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
|
}
|