手机支付控件接入指南.pdfVIP

支付控件接入指南1

1概述3

2接入流程3

2.1申请资源3

2.2快速接入3

3支付流程8

4Android客户端9

4.1SDK结构说明9

4.2接口说明9

4.2.1初始化【客户端调用】(必接)9

4.2.2登录接口【客户端调用】(必接) 9

4.2.3切换接口【客户端调用】(选接)10

4.2.4创建角色接口【客户端调用】(必接)11

4.2.5销毁接口【客户端调用】(必接) 11

4.2.5支付接口【客户端调用】(必接) 11

4.2.5游戏接口【客户端调用】(必接)12

4.2.6支付结果通知接口-接入方服务器端提供实现(必接)12

4.2.7用户接口【客户端调用】(选接)14

4.2.8登录二次验证接口【客户端调用】(选接)14

5权限与配置15

5.1权限15

5.2ACTIVITYSERVICE15

5.3Key21

6开发者注意事项22

7附录22

1概述

支付控件(以下简称支付控件),主要为合作商户的客户端提供安全、

便捷的支付服务。支付控件目前支持Android平台。用户通过在支付控件中输入

本sdk为安卓应用提供登录、、支付、礼包、资讯等功能。面向的读者

是安卓应用开发者，包括客户端和服务器工程师。

2接入流程

2.1申请资源

key申请

接入方需要在开放平台内申请app_key、app_private_key以及

app_secret_key。一个游戏对应一组唯一的key。其中app_key和app_private_key

配置在客户端中使用。app_secret_key在服务端使用，用于签名校验。

回调地址配置

接入方需要将支付成功回调地址在开放平台内进行录入。在支付的时候，会

将该地址和传入的地址做对比。

注意将商户应用包名后缀追加.papa。

2.2快速接入

SDK开发资料中包含了一个样例工程。该工程提供了一个接入的范例。可以

看到接入所需的所有样例代码及各功能演示。生产环境可依照该样例工程进行配

置、使用。具体代码在文件夹“客户端开发包及demo-Android”中。

1.IntellijIDEA或studio样列

papaSdkLib是依赖库，主工程需要依赖此工程运行。

sdkDemo是demo的主工程(对应游戏主工程)。

确保lib工程文件完整，包括:assets内的so文件，data.bin，libs文件夹内

jar包。

papapaylib.jar，注意不要重复添加jar包。

Library工程注意在引入jar包时在Export中勾选papapaylib包。

主工程需要在packaging中选中IncludeassetsfromdependenciesintoAPK

2.Eclips环境

2.1、导入lib工程papaSdkLib并引入主工程如下图

2.2、确保lib工程完整性。

注意：此lib工程已包含的jar包如下图，其中红色方框选中的lib包需

要可以移至主工程或者使用新版本jar包。其他jar已打入papapaylib.jar，

注意不要重复添加jar包。

2.3、lib工程中引入libs中的所有jar包。并勾选privatelibraies如下图配置

2.4、将library工程下的assets中的内容，移动到主工程assets中。

也可将依赖包、asserts全部