新手指南更新时间:2017-09-13 

一、入驻成为开发者

要使用力方开放平台任何设施,首先要成为开放平台的开发者。如果您已经是力方用户,可以直接登录开放平台控制台入驻,不需要再次注册,如果您是作为第三方ISV入驻,需要新注册开发者账号。

点击右上角"注册"按钮"进入开发者账号注册页面。

二、熟悉接入指南

为了更好的服务力方接入用户,我们提供了力方开放平台接入指南,请力方接口用户在对接之前务必熟悉指南文档,按照指南流程操作,以免不必要的麻烦。根据自身的版本选择下载指南,只有明确版本才能快速高效的接入开放平台。

旗舰版下载:接入指南(旗舰版)-PDF版

接口版下载:接入指南(接口版)-PDF版

三、创建应用

根据接入指南或者白皮书中的要求,在完成应用创建前的一些前置设置或者认证以后,可以直接在“控制台 > 创建应用”页面进行创建,填写应用名称,选择好标签,完成应用创建。如下图:

四、获取AppKey和AppSecret

应用创建完成,进入应用管理,在证书管理页面可以查看appKey和appSecret,在实际开发之前,您需要补充应用的基本信息,包括应用图标等等信息。

五、开发测试

API文档结构

包括API的调用方式,和API文档本身,API为HTTP(或HTTPS)接口调用方式,一个完整的API文档包括以下内容:

  • 当前API是否需要授权(调用当前API是否需要传access_token参数)。
  • 调用API的系统级参数(所有API调用均需要传的一些公共入参)。
  • 当前API相关的业务级参数。
  • 当前API的请求示例(仅仅是SDK示例)。
  • 当前API的相应参数(返回值,点击可展开查看字段详情)。
  • 当前API的响应示例(返回示例json)。
  • 当前API可能返回的业务异常。
  • 当前API的FAQ补充问题描述。
相关技术文档

六、发布上线

应用开发测试完毕以后,您需要将应用发布上线,未上线的应用限制API的调用流量为5000次/天,商家后台应用直接在应用向导中发布。

七、常见问题

一、BMOP的API是采用的什么协议?支持哪些接入终端?

BMOP的接口基本约定如下:

  • 通讯协议: HTTP协议,查询类接口请使用GET方式,操作类请使用POST方式。
  • 编码格式: 所有请求/响应均为 UTF-8。
  • 数据格式: 为了减少网络开销,使用JSON数据格式。
  • SDK工具包: 提供了常用的JAVA、PHP、.NET等SDK,请优先使用SDK进行开发。
  • 接入终端: PC端、APP(IOS,Android)端、微信公众号等支持发起HTTP请求的其他第三方平台或系统均可接入。
二、力方便民应用第三方会员充值缴费,怎么实现?

由于第三方应用/平台上面的会员不是力方的会员用户,所以不直接跟力方直接产生交易,需要通过BOSS用户作为中间人进行交易,我们推荐的第三方充值缴费应用/平台的对接流程如下:

  • 1、力方BOSS商家在BOSS后台对接好商品(货源)、查询模板、建立直销商账号(用于力方授权账号对接),该步骤必须。
  • 2、第三方应用/平台给您的会员提供话费、水电煤等查询功能,后台调用力方开放平台查询话费、水电煤等账户信息,该步骤可选。
  • 3、第三方应用/平台提供本地下单并支付成功,支付功能(支付网关需要自己对接,本地交易资金直接本地结算,资金入第三方应用)。
  • 4、第三方应用/平台调用力方开放平台下单并支付接口(直销商余额支付),第三方订单编号可作为外部订单号传入,第三方应用需要保存生成的订单与本地下单的订单做关联映射。
  • 5、如果力方开放平台下单并支付接口成功,则需要通过开放平台消息服务监听充值订单充值状态变更消息,及时更新本地订单数据。
  • 6、对于异常订单,如果充值失败,力方会原路退回直销商账号余额,第三方应用/平台收到充值失败的状态消息,处理本地订单退款给终端会员。
三、力方充值订单我如何知道成功还是失败了?是否有回调功能?

回调方式受限于被回调方系统的稳定性,可靠性,网络超时等原因,BMOP为了保证整个平台的高并发稳健运行,根据力方自身架构特点,研发了目前业内领先的主动通知服务(异步消息通知), 采用SDK长连接或API拉取消息或回调地址推送等方式实现消息通知,充值成功或失败以后,BMOP会通过这几种方式将订单的充值状态推送到ISV(第三方)应用,详情请查看“消息服务使用说明”文档。