被扫接口列表(商户被扫接口)

需要授权

该接口提供商户收银系统或哆啦宝商户APP扫用户手机付款码进行支付时使用, 用户打开微信(支付宝)付款界面,商户收银系统或哆啦宝商户APP扫描用户付款二维码或条码进行收款。

POST请求参数:

请求地址:

环境 https请求地址
正式环境 https://openapi.duolabao.cn/v1/customer/passive/create

公共请求参数:

参数名称 参数类型 是否必填 最小长度 最大长度 参数说明 示例值
customerNum String 32 商户编号 10001214513673242442196
authCode String 32 用户付款码 212228325025
machineNum String 32 机具编号 10011014593073262477203
shopNum String 32 店铺编号 10001214653797401143127
requestNum String 18 32 流水号(用户系统内唯一) 建议时间戳+5位以上随机数(纯数字)
amount String 15, 2 支付金额 单位:元,精确到分 100.00
source String 32 固定 API
tableNum String 11 桌号 15

请求示例:

  • 示例
  • 1 {
    2 "customerNum": "10001214513673242442196",
    3 "authCode":"212228325025",
    4 "machineNum": "10011014593073262477203",
    5 "shopNum": "10001214653797401143127",
    6 "requestNum": "315080832507485",
    7 "amount":"100.00",
    8 "source":"API",
    9 "tableNum":"15"
    10 }

返回参数JSON格式:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
result String 32 success表示成功,fail表示失败,error表示异常 success
errorCode String 32 详见错误码表 shopNumNotExist
errorMsg String 32 详见错误信息 shopNum not exist

响应示例:

  • 示例
  • 1 {
    2 "data": {
    3 "message":"pay proccessing,please check the order status.If the payment is not successful,
    please confirm the authCode or network reason."
    4 },
    5 "result": "success"
    6 }

错误响应示例:

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

错误码解释:

错误码 错误描述 解决方案
orderNotInit order not inited 订单未被创建,请确认订单
payResultError pay return result info error 支付返回有误
payRepeatRequest pay repeat request 支付重复请求
paySystemError pay system error 支付错误,请重新进行支付
machineNotExist machine not exist 机具不存在,请确认机具号
shopNotExist shop not exist 店铺不存在,请确认店铺
shopIsClosed shop is closed 店铺已关闭,请确认店铺
customerNotExist customer not exist 商户不存在请确认商户
customerInvalid customer invalid 商户无效,请确认商户
shopInvalid shop invalid 店铺无效,请确认店铺
amountInvalid amount invalid 金额无效,请确认金额
sourceInvalid source invalid 来源无效,请确定来源