代理商接口列表 (创建支付链接)

需要授权

代理商通过该接口创建交易的支付链接。

请求参数:

POST请求地址:

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

公共请求参数:

参数名称 参数类型 是否必填 最小长度 最大长度 参数说明 示例值
agentNum String 32 代理商编号 10001114514826219621868
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示例:

  • JSON示例
  • 1 {
    2 "agentNum": "10001114514826219621868",
    3 "customerNum": "10001114495558121971726",
    4 "shopNum": "10001214653797401143127",
    5 "machineNum": "10011014593073262477203",
    6 "requestNum": "2014072300007148",
    7 "amount": "100.00",
    8 "tableNum": "15",
    9 "source": "API",
    10 "callbackUrl":"openapi.duolabao.com",
    11 "extraInfo":"自定义扩展信息"
    12 "completeUrl":"https://openapi.duolabao.com"
    13 }

返回参数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示例:

  • 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 生成支付链接失败,请重新生成支付链接