FunnelFox 接入说明
接入 FunnelFox 所需配置
1. BytePower Console 配置
在 BytePower Console 上完成以下配置:
- FunnelFox 平台配置
- FunnelFox 商品配置
2. FunnelFox 后台配置
联系 FunnelFox 的工作人员,在后台配置 Notification,notification URL 形如:
https://{host_name}/bp/server/funnelfox/callback其中 host_name 是 BytePower Console 上对应的 App 域名。
3. Primer 后台配置
在 Primer 后台进行相应配置。
订阅购买过程
步骤 1:拉取商品配置
使用 bp/asset/product_configs API 拉取商品配置。
步骤 2:创建订阅
在配置中选择要购买的商品,调用 POST /bp/asset/{platform}/subscription 创建订阅。
步骤 3:前端创建交易
在前端创建 FunnelFox 交易并付费,并将第 2 步返回的 bp_sub_id 添加到 clientMetadata 中。
步骤 4:同步充值结果(可选)
购买成功后,调用 POST /bp/asset/{platform}/subscription/sync 接口同步充值结果。
关于 Sync 接口
第 4 步 sync 接口的调用是可选的。
不调用的话,BytePower 也可以接收 FunnelFox 的 webhook 进行充值,sync 接口的调用只是同步 webhook 的处理结果。
其它 API
完整的 API 文档请参考:FunnelFox API 文档
按需调用以下 API:
- 变更 Product
- 取消订阅
- 退款
- 其它订阅管理操作
