商户接口列表 (创建支付链接)
需要授权
哆啦宝包装的页面,商户通过该接口创建交易的支付链接,可通过扫码进入哆啦宝固定金额支付页面。
请求参数:
POST请求地址:
环境 |
https请求地址 |
正式环境 |
https://openapi.duolabao.com/v1/customer/order/payurl/create |
公共请求参数:
参数名称 |
参数类型 |
是否必填 |
最小长度 |
最大长度 |
参数说明 |
示例值 |
customerNum |
String |
是 |
|
32 |
商户编号 |
10001114513826266541863 |
shopNum |
String |
是 |
|
32 |
店铺编号 |
10001214653797401143127 |
machineNum |
String |
否 |
|
32 |
建议填写虚拟机具序列号 |
10011014593073262477203 |
requestNum |
String |
是 |
18 |
32 |
流水号(用户系统内唯一) |
建议时间戳+5位以上随机数(纯数字) |
amount |
String |
是 |
|
15, 2 |
订单金额,单位:元,精确到分 |
100.00 |
source |
String |
是 |
|
255 |
定值:API |
API |
tableNum |
String |
否 |
|
11 |
桌号 |
15 |
callbackUrl |
String |
否 |
|
255 |
(可选)交易完成后,会调用此地址通知交易结果(目前只有交易成功会通知) |
openapi.duolabao.com |
extraInfo |
String |
否 |
|
255 |
(可选)用户自定义扩展信息(不支持中文字符) |
自定义扩展信息 |
completeUrl |
String |
否 |
|
255 |
(可选)用户自定义支付完成页 |
自定义支付完成页 |
请求JSON示例:
-
1
|
{
|
2
|
"customerNum": "10001114513826266541863",
|
3
|
"shopNum": "10001214653797401143127",
|
4
|
"machineNum": "10011014593073262477203",
|
5
|
"requestNum": "2014072300007148",
|
6
|
"amount": "100.00",
|
7
|
"tableNum": "15",
|
8
|
"source": "API",
|
9
|
"callbackUrl":"openapi.duolabao.com",
|
10
|
"extraInfo":"自定义扩展信息"
|
11
|
"completeUrl":"https://openapi.duolabao.com"
|
12
|
}
|
返回参数JSON格式:
参数名称 |
参数类型 |
是否必填 |
最大长度 |
参数说明 |
示例值 |
result |
String |
是 |
32 |
success表示成功,fail表示失败,error表示异常 |
success |
errorCode |
String |
否 |
32 |
详见错误码表 |
shopNumNotExist |
errorMsg |
String |
否 |
32 |
详见错误信息 |
shopNum not exist |
url |
String |
否 |
255 |
二维码链接(根基url生成二维码) |
https://order.duolabao.com/active/c?state=315080832507485%7CmachineNum%7C10.50%7C15%7CPCCLIENT
|
响应JSON示例:
-
1
|
{
|
2
|
"data": {
|
3
|
"url":
"https://order.duolabao.com/active/c?state=315080832507485%7Cmachine
|
|
Num"%7C10.50%7C15%7CPCCLIENT"
|
4
|
},
|
5
|
"result": "success"
|
6
|
}
|
错误响应示例:
-
1
|
{
|
2
|
"error": {
|
3
|
"errorCode": "shopNumNotExist",
|
4
|
"errorMsg": "shopNum not exsit"
|
5
|
},
|
6
|
"result": "fail"
|
7
|
}
|
异常示例:
-
1
|
{
|
2
|
"error": {
|
3
|
"errorCode": "systemError",
|
4
|
"errorMsg":"错误描述"
|
5
|
},
|
6
|
"result": "error"
|
7
|
}
|
错误码解释:
错误码 |
错误描述 |
解决方案 |
paramsError |
requestNum must be specified |
参数不正确,请确认参数 |
amountInvalid |
amount invalid |
金额无效,请确认金额 |
requestNumInvalid |
requestNum invalid |
流水号无效,请确认流水号 |
tableNumInvalid |
tableNum invalid |
桌号无效,请确认桌号 |
callbackUrlInvalid |
callbackUrl invalid |
回调地址无效,请确认回调地址 |
extraInfoInvalid |
extraInfo invalid |
扩展信息无效,请确认扩展信息 |
customerNotExist |
customer not exist |
商户不存在 |
customerNotActive |
customer not active |
商户未激活 |
shopNotExist |
shop not exist |
店铺不存在 |
shopIsClosed |
shop is closed |
店铺已关闭 |
machineNotExist |
machine not exist |
机具不存在 |
machineNotUsing |
machine not using |
机具未使用 |
machineExsit |
machine:[编号] is exsit |
机具号已经存在,请确认机具号 |
generalUrlFailed |
general url failed |
生成支付链接失败,请重新生成支付链接 |