根据商户ID+手机号获取商户信息

接口地址 /openapi/v1/user/check-merchant

接口描述 通过已注册的用户/商户ID+手机号来匹配返回对应的用户/商户信息，接口返回参数同接口（根据验证码获取绑定信息）

请求方式 POST

适用条件 根据商户ID+手机号获取商户信息

请求参数例子

{
  "phone": "13888888888",
  //手机号
  "accountNo": "XD1231231231"
  //用户/商户ID
}

返回参数例子

{
  "code": 0,
  "msg": "操作成功",
  "data": {
    "phone": "13888888888",
    //手机号
    "nickName": "海上捞",
    //商家昵称
    "accountNo": "XD888888",
    //裹小递唯一商家ID
    "balanceAmount": "10002",
    //账户可用余额,单位：分
    "arrearsAmount": "10002"
    //账户欠款金额,单位：分
  },
  "timestamp": "2021-03-24 11:59:31",
  "timeStampNow": 1607929171334,
  "ok": true,
  "fail": false
}

获取开放平台绑定验证码

接口地址 /openapi/v1/user/send-bind-code

请求方式 POST

适用条件 商户在发单方，发送手机验证码

请求参数例子

{
  "phone": "13888888888"
  //手机号
}

返回参数例子

{
  "code": 0,
  "msg": "操作成功",
  "data": {
    "phone": "13888888888",
    //手机号
    "codeUuid": "1234asda134141"
    //验证码对应的id
  },
  "timestamp": "2022-03-24 11:59:31",
  "timeStampNow": 1607929171334,
  "ok": true,
  "fail": false
}

{
  "code": -1,
  "msg": "发送失败",
  "data": null,
  "timestamp": "2022-03-24 11:59:31",
  "timeStampNow": 1607929171334,
  "ok": false,
  "fail": true
}

根据验证码获取绑定信息

接口地址 /openapi/v1/user/check-bind-user

接口描述 如果当前手机号已在裹小递注册，则返回已注册的用户信息。如果手机号未在裹小递注册，根据参数规则自动注册为新用户，[merchantsName，locationAddress，location] 三个参数填写完整的则生成商户账户，不填写或者不完整填写则生成普通用户

请求方式 POST

适用条件 根据手机号+验证码获取绑定信息

请求参数例子

{
  "phone": "13888888888",
  //手机号
  "codeUuid": "1234asda134141",
  //code_uuid
  "codeValue": "1234",
  //code_value(短信验证码)
  "merchantsName": "XX烤肉店",
  //商户名称(选填:生成商户时必填，普通用户可以不填，如果商户名称，地址，经纬度全部填写则生成商户反之生成普通用户
  "locationAddress": "深圳市南山区XX大厦",
  //商家地址信息(选填:生成商户时必填，普通用户可以不填，如果商户名称，地址，经纬度全部填写则生成商户反之生成普通用户
  "location": "113.924857,22.532357"
  //商家地址经纬度(选填:生成商户时必填，普通用户可以不填，如果商户名称，地址，经纬度全部填写则生成商户反之生成普通用户
}

返回参数例子

{
  "code": 0,
  "msg": "操作成功",
  "data": {
    "phone": "13888888888",
    //手机号
    "nickName": "海上捞",
    //商家昵称
    "accountNo": "XD888888",
    //裹小递唯一商家ID
    "balanceAmount": "10002",
    //账户可用余额,单位：分
    "arrearsAmount": "10002"
    //账户欠款金额,单位：分
  },
  "timestamp": "2021-03-24 11:59:31",
  "timeStampNow": 1607929171334,
  "ok": true,
  "fail": false
}

{
  "code": -1,
  "msg": "验证码已过期",
  "data": null,
  "timestamp": "2022-03-24 11:59:31",
  "timeStampNow": 1607929171334,
  "ok": false,
  "fail": true
}

获取裹小递方商户钱包

接口地址 /openapi/v1/user/query-wallet

请求方式 POST

适用条件 发单方获取商家在裹小递方储值账户信息

请求参数例子

{
  "phone": "13888888888"
  //手机号
}

{
  "accountNo": "XD888888"
  //裹小递方商家ID
}

返回参数例子

{
  "code": 0,
  "msg": "操作成功",
  "data": {
    "phone": "13888888888",
    //手机号
    "nickName": "海上捞",
    //商家昵称
    "accountNo": "XD888888",
    //裹小递唯一商家ID
    "balanceAmount": "10002",
    //账户可用余额,单位：分
    "arrearsAmount": "10002"
    //账户欠款金额,单位：分
  },
  "timestamp": "2021-09-04 11:59:31",
  "timeStampNow": 1607929171334,
  "ok": true,
  "fail": false
}

{
  "code": 1800,
  "msg": "商家不存在",
  "data": null,
  "timestamp": "2021-09-04 11:59:31",
  "timeStampNow": 1607929171334,
  "ok": false,
  "fail": true
}

裹小递通用充值页

页面地址 https://iguoxiaodi.com/openRecharge?deviceType=pc&accountNo=

请求方式 GET

适用条件 当商家选择裹小递余额充值时，可跳转至此url，并在url上拼接如下业务参数，让用户能快速充值余额

业务参数示例

字段	类型	是否必填	说明
deviceType	string	否：默认pc	设备类型，可选pc或app，pc表示PC浏览器等桌面设备，app表示H5浏览器或移动应用，默认pc
accountNo	string	是	裹小递侧用户商户ID