友朋运营商开放平台
  1. 业务场景
友朋运营商开放平台
  • 友朋运营商平台第三方开放平台接口文档
  • 业务场景
    • 场景:自取柜第三方支付业务逻辑
    • 场景:异步通知第三方业务回调地址
    • 场景:自取柜售货机订单同步给第三方
  • API 列表
    • api.test
      POST
    • cabinet.list
      POST
    • cabinet.product.stock
      POST
    • cabinet.open.door
      POST
    • cabinet.order.refund.apply
      POST
    • cabinet.order.user.appeal
      POST
    • cabinet.order.list
      POST
    • cabinet.order.get
      POST
    • consumer.order.list
      POST
    • consumer.order.get
      POST
  1. 业务场景

场景:自取柜售货机订单同步给第三方

💡
使用背景:运营商购买友朋自取柜后,希望将设备的交易订单数据同步回到自己的ERP系统,实现自己系统内的业务逻辑,如库存出库,订单销售统计等。

01. 订单实时回调方案#

开发者前置动作:
根据 友朋运营商平台第三方开放平台接口文档 完成开发者的appid、appSecret的创建,回调地址配置,及所需权限勾选。
订单同步必选权限:
售货机订单:【异步通知 - 订单通知】【订单数据-订单信息】
自取柜订单:【异步通知 -自取柜支付结果通知】【订单数据-自取柜订单详情】
友朋通知开发者配置的回调地址实现:
请按文档实现接收通知 场景:异步通知第三方指定回调地址

1.1 自取柜业务流程及所需实现的接口#

① 异步通知接口 notify.cabinet.order.simple#

接口通知说明
自取柜的订单完成支付后触发,通知到开发者配置的业务回调地址,开发者接收后缓存起来或落盘存储。
业务参数
参数名称类型是否必须说明
ReceiptNostringY订单交易编号
CIDstringY自取柜设备 ID
PayTimeintY支付时间

② 根据友朋异步通知的 ReceiptNo 查询自取柜订单详情 cabinet.order.get#

1.2 售货机业务流程及所需实现的接口#

① 异步通知接口 notify.consumer.order.simple#

接口通知说明
售货机设备上报出货结果时触发
业务参数
参数名称类型说明
ReceiptNostring订单交易编号
TIDstring售货机设备 ID
ShipmentsStatusint出货结果
ShipmentsErrorstring失败原因

② 根据友朋异步通知的 ReceiptNo 查询售货机订单详情 consumer.order.get#

2. 定时批量获取订单信息#

注意
定时批量获取订单,如订单量数据量超过10000单,建议在中国北京时间凌晨4点-6点区间获取,避免被服务器拒绝服务,批量获取订单信息限制了QPS。

2.1 自取柜批量获取订单信息#

使用 cabinet.order.list 接口,通过时间段批量分页获取订单信息。

2.2 售货机批量获取订单信息#

使用 consumer.order.list 接口,通过时间段批量分页获取订单信息。
修改于 2024-02-29 06:27:21
上一页
场景:异步通知第三方业务回调地址
下一页
api.test
Built with