商户接口列表 (创建支付链接)
需要授权
哆啦宝包装的页面，商户通过该接口创建交易的支付链接，可通过扫码进入哆啦宝固定金额支付页面。
请求参数：
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 |
生成支付链接失败，请重新生成支付链接 |