移动端支付插件

Android接口规范

版本 (V1.0)

网银在线（北京）科技有限公司

修改记录

目录

1. 文档说明 3

1.1. 文档目标 4

1.2. 阅读对象 4

1.3. 术语预定 4

2. 插件使用 4

2.1. 数据交互流程 4

2.1.1.业务接入 5

2.1.2.代码接入 5

2.2. 参数说明 6

2.2.1 编码格式 6

2.2.2 商户提交到网银在线 6

2.2.3 网银在线返回到商户 8

2.2.4 向notifyUrl发送的请求包含内容 8

2.2.4.2样例 8

2.3. 开发注意事项 10

2.3.1 关于密钥 10

2.3.2 关于订单处理 10

3. 参考资料 11

3.1. 网关错误列表 11

4. 附录 11

4.1.网银在线资源 11

4.2.技术支持 11

1. 文档说明

1.1. 文档目标

本文档是网银在线移动端支付插件及附录文档，它详细解释了在技术接入与使用过程中需要注意的地方，帮助商户快速理解和实现移动端支付功能。

阅读后如有疑问，请联系网银在线相关技术支持。

1.2. 阅读对象

商户系统设计人员、编程人员及测试人员。该人员需要具备一定的网站开发能力，了解ios，android开发语言，并对信息安全有一定的认识。

1.3. 术语预定

2. 插件使用

2.1. 数据交互流程

2.1.1.业务接入

商户客户端调用插件等需要提供的几个数据：

订单信息：用于完成转账，双方对账，由商户提供

用户信息：用于填充界面上的卡信息/用户信息等，提高用户体验，由商户提供，插件内部隐藏。

2.1.2.代码接入

商户客户端需要引入一个工程（WangYinPay），和一个jar包（wangyinpaycore），同时将权限和界面声明加入AndroidManifest.xml中（具体内容请参见DEMO）。

说明：

WangYinPay：负责提供支付需要的资源/界面等文件，引用wangyinpaycore控制流程

wangyinpaycore：负责提供支付相关接口和流程封装，以及简单的工具类

TrdClient：负责引入WangYinPay提供的各支付界面，完成支付。（工作由商户客户端完成）

AndroidManifest.xml样例：

2.2. 参数说明

2.2.1 编码格式

移动端的插件采用utf-8格式。

2.2.2 商户提交到网银在线

2.2.3 网银在线返回到商户

由输入参数中的requestActivity接收支付结果(结果存于onActivityForResult中Intent的Bundle中)：

2.2.4 向notifyUrl发送的请求包含内容

2.2.4.1 报文内容

2.2.4.2样例

2.3. 开发注意事项

2.3.1 关于密钥

2.3.2 关于订单处理

商户程序接收到网银在线的通知后，一定要先判断这笔订单是否已经处理，如果未处理，才执行自己网站的业务逻辑。如果已经处理，就不要重复处理订单。

如果重复处理，会给自己的网站带来不必要的损失。

3. 参考资料

3.1. 网关错误列表

pay接口调用返回字符串，客户端负责提示

pay接口调用后的进度界面由插件负责。

pay内部负责提示支付过程中的错误提示。

4. 附录

4.1.网银在线资源

网银在线官网地址：http://www.chinabank.com.cn

4.2.技术支持

如果您有任何技术上的疑问，可按如下方式联系我们

邮箱： ts@chinabank.com.cn

网银在线移动端支付插件(android)v1.0（对外商户版）