接口 cabinet.open.door
接口说明
业务场景：第三方需接入自有支付通道，并指定某自取柜进行开门。 在请求开门前，请确保消费者已授权自有闭环可实现扣款业务逻辑（如微信支付分、支付宝芝麻信用等）。 需配合异步通知 notify.close.door 接口使用
业务参数
| 参数名称 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| cid | string | Y | 自取柜 id |
| tradeNo | string | Y | 第三方系统唯一的订单号，尽可能采用支付通道的订单号，避免后期二次对账 |
| mobile | string | Y | 手机号 |
| doorNum | int | Y | 设备门号 单门柜传 1；双门柜右门为 1，左门为 2 |
返回示例
成功
{
"error_code": 0,
"error_msg": "SUCCESS",
"data": {
"ReceiptNo": "108284445710", // 友朋系统产生的唯一订单号
"NotifyUrl": "" // 当第三方开发者的业务系统完成支付后，需按照友朋的第三方支付回调接口要求，回调此URL。
}
}
失败
{
"error_code": -1,
"error_msg": "错误信息",
"sub_error_code": 400001,
"sub_error_msg": ERR_CABINET_ACTIVESTATUS_INVALID,
"data": {}
}
错误信息列表
| 中文错误提示 | 错误码(sub_error_code) | 英文错误提示(sub_error_msg) |
|---|---|---|
| 设备还未激活，请先配置后重试 | 400001 | ERR_CABINET_ACTIVESTATUS_INVALID |
| 设备维护中: 设备未开启售卖状态 | 400002 | ERR_CABINET_NOT_ON_SALE |
| 提示: 你有不良记录，暂无法提供服务，如需解除请联系运营商 | 400003 | ERR_USER_HAS_RECORD_UNABLE_TO_PROVIDE_SERVICES |
| 提示: 您有等待支付的订单，请支付后再开门 | 400004 | ERR_USER_HAS_UNPAID_ORDER_UNABLE_TO_OPEN_DOOR |
| 运营商系统维护中，维护代码: 888888 | 400005 | ERR_VISUAL_IDENTITY_FEE_ARREARS |
| 设备服务已到期，请续费后重试 | 400006 | ERR_VISUAL_IDENTITY_FEE_EXPIRED |
| 设备维护中: 设备断网了，请稍后再试 | 400007 | ERR_CABINET_MAINTENANCE_NETWORK_ISSUE |
| 错误: 设备状态获取失败，请反馈给友朋 | 400008 | ERR_CABINET_STATUS_FETCH_FAILED |
| 设备维护中：请先设置商品售价 | 400009 | ERR_CABINET_MAINTENANCE_SET_PRICE_FIRST |
| 错误：订单创建失败，请反馈给友朋 | 400010 | ERR_ORDER_CREATION_FAILED |
| 错误: 自取柜开门失败 | 400011 | ERR_LOCKER_OPEN_DOOR_FAILED |
| 错误: 设备不在线，开门失败 | 400012 | ERR_DEVICE_OFFLINE_OPEN_DOOR_FAILED |
| 错误: 自取柜被禁用, 请联系友朋客服 | 400013 | ERR_LOCKER_DISABLED_CONTACT_SUPPORT |
| 提示: 设备正在购物/补货中, 开门失败 | 400014 | ERR_DEVICE_IN_USE_OPEN_DOOR_FAILED |
| 错误: 设备断电, 请检查设备电源线 | 400015 | ERR_DEVICE_POWER_OFF_CHECK_POWER_CABLE |
| 错误: 设备摄像头异常，开门失败 | 400016 | ERR_DEVICE_CAMERA_FAULT_OPEN_DOOR_FAILED |
| 错误: 设备异常或欠费, 请联系友朋 | 400017 | ERR_DEVICE_FAULT_OR_FEE_DUE_CONTACT_SUPPORT |
| 错误: 开门失败，设备未配置商品，请联系商家 | 400018 | ERR_OPEN_DOOR_FAILED_DEVICE_NOT_CONFIGURED_CONTACT_MERCHANT |
| 错误: 设备门锁异常，开门失败 | 400019 | ERR_DEVICE_DOOR_LOCK_FAULT_OPEN_DOOR_FAILED |
| 错误: 用户开门过于频繁, 请稍后重试 | 400020 | ERR_USER_OPEN_DOOR_TOO_FREQUENTLY_TRY_AGAIN_LATER |
| 错误: 未知错误,
请联系友朋客服 | 400021 | ERR_UNKNOWN_ERROR_CONTACT_SUPPORT | | 错误: 设备不在线, 请联系友朋客服 | 400022 | ERR_DEVICE_OFFLINE_CONTACT_SUPPORT |