【API接口】对接
本文档适用于通过技术手段API接口方式对接蜜蜂平台的用户，可对接业务包括：
虚拟商品业务【话费、直播/游戏币、餐饮代下单、会员权益、官方卡密卡券、二手卡密卡券】
技术服务产品【话费卡密代充、油卡CK代充、携号空号查询】
虚拟商品业务【话费、直播/游戏币、餐饮代下单、会员权益、官方卡密卡券、二手卡密卡券】
技术服务产品【话费卡密代充、油卡CK代充、携号空号查询】
对接前必读
部分业务的放单API对接
| 名称 | 接口 | 是否必须 | 描述 | 接口地址 |
|---|---|---|---|---|
| 代充放单API | /api/merchant/upload_order | 订单交易必须 | 推送需要充值订单给平台 | API地址 |
| 油卡CK代充放单API | /api/merchant/upload_order | 订单交易必须 | 推送需要充值订单给平台 | API地址 |
| 携号空号查询API | /api/merchant/upload_order | 订单交易必须 | 推送需要充值订单给平台 | API地址 |
通用订单对接API说明（订单必选-通用）
| 名称 | 接口 | 是否必须 | 描述 | 接口地址 |
|---|---|---|---|---|
| 放单API | /api/merchant/upload_order | 订单交易必须 | 推送需要充值订单给平台 | 通用API |
| 查单 | /api/merchant/order_info | 和回调必选二选一 | 查询订单当前结果状态 | API地址 |
| 订单状态回调 | 对接方提供 | 和查单必选二选一 | 放在放单API提交参数call_back_url 订单完结后会自动根据地址回调 | API地址 |
| 商户订单退款请求 | /api/merchant/order_refund | 订单交易必须 | 订单退款请求 | API地址 |
| 商户订单退款结果通知回调 | 对方提供 | 订单交易必须 | 商户订单退款结果通知回调 | API地址 |
| 余额查询 | /api/merchant/account | 可选对接 | 获取当前账户资金明细 | API地址 |
| 订单做单日志 | /api/merchant/orderLogList | 可选对接 | 获取订单做单资源明细 | API地址 |
| 批量查询订单 | /api/merchant/order_list | 可选对接 | 批量查询订单当前状态 | API地址 |
| 批量查询订单 | /api/merchant/order_list | 可选对接 | 批量查询订单当前状态 | API地址 |
| 查询商品列表 | /api/merchant/productGoodsListNew | 报价必选 | 查询蜜蜂汇云平台商品 | API地址 |
| 修改商品报价 | /api/merchant/productGoodsPriceSave | 报价必选 | 走接口报价 | API地址 |
| 商户自定义超时时间 | /api/merchant/productSkuGoodsTimeOutSave | 可选对接 | 自定义订单执行时间 | API地址 |
商品对接API说明（价格联动必选-通用）
| 名称 | 接口 | 是否必须 | 描述 | 接口地址 |
|---|---|---|---|---|
| 商品价格订阅 | /api/merchant/cancelSubscribePriceNotify | 可选对接 | 订阅商品后，当商品价格发生变化会根据订阅信息价进行价格推送 | API地址 |
| 商品取消订阅 | /api/merchant/subscribePriceNotify | 可选对接 | 取消指定商品的价格订阅 | API地址 |
| 商品价格变更推送 | 对接方提供 | 订阅必选 | 系统根据价格变更情况实时推送价格信息 | API地址 |
| 商品自定义放单超时时间设置 | 可选对接 | 修改超时时间必选 | 商品自定义放单超时时间设置 | API地址 |
修改于 2025-12-10 10:20:02