一、入驻成为开发者

要使用力方开放平台任何设施,首先要成为开放平台的开发者。如果您已经是力方用户，可以直接登录开放平台控制台入驻，不需要再次注册，如果您是作为第三方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，查阅：API调用详解
• 如何使用官方SDK进行开发，查阅：SDK使用说明
• 什么叫用户授权，查阅：用户授权介绍
• 如何使用消息服务，查阅：消息服务使用说明

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

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（第三方）应用，详情请查看“消息服务使用说明”文档。