酷派SDK配置说明（网游）

一、接入前的准备

1. 申请酷派开发者账号

开发者账号目前由接口的商务人员分配(如果是老CP，即在http://pay.coolyun.com:6081/ccxr/sso.lzyhjfs有帐号的，就用原有的帐号和密码登录开发者平台即可)。酷派商务联系方式：QQ：1332616000（李鹏）

2. 创建应用

获取开发者账号后登陆开发者平台:http://appdev.coolyun.com/ylra/

点击新增按钮创建应用

填写应用相应的信息。

在资源管理标签中可以看到您所有的应用，同时也可以看到系统自动分配的appid

该appid为支付、账号通用的appid。

3. 获取KEY

点击密钥按钮获得appkey

4. 创建计费点

在首页下点击支付系统，进入创建计费点的界面

跳转到计费点添加页面后点修改应用信息

跳转至下图页面后即可对计费点、应用信息、支付方式进行编辑。

5. 配置支付回调地址

酷派两种配置地址方式：

方式一，渠道后台配置。

进入【应用管理】->【应用信息】，填写支付回调地址：

获取该渠道的游众平台回调地址

使用时请把回调地址中的APPID替换为在游众注册的应用ID，去掉大括号{}和中间的-。

方式二，客户端配置。游众使用客户端配置支付回调地址。直接打包后，在插件中自动配置支付回调地址，无需手动添加；

6. 查看统计信息

在首页下点击统计系统，进入统计信息的界面

跳转到下图页面中查看相应统计信息：

二、游众工具参数说明

SDK信息：

1.AppID：酷派的支付和账户appid，查看方法：登录酷派开放者平台http://appdev.coolyun.com/ylra，首页的APP ID

2.应用私钥：酷派的应用私钥。获取方式：登录酷派开放者平台http://appdev.coolyun.com/ylra，在资源管理页点击“密钥按钮”，弹出框中的【应用私钥】

3.平台公钥：酷派的平台公钥。获取方式：登录酷派开放者平台http://appdev.coolyun.com/ylra，在资源管理页点击“密钥按钮”，弹出框中的【平台公钥】

4.AppKey：酷派的账户私钥。获取方式：登录酷派开放者平台http://appdev.coolyun.com/ylra，在资源管理页点击“密钥按钮”，弹出框中最下面的【appkey】（redirect_uri的值也要用这个appkey，不然会报错）

5.游戏助手透明度：设置游戏助手的透明度。0为完全透明。

6.游戏助手：设置游戏助手是否打开。

7.横竖屏：设置支付和登陆界面的横竖屏。

三、注意事项

1.包名无特殊要求。

2.无角标。

3.有游戏浮标，即游戏助手。可通过工具设置是否开启以及手机助手的透明度。

关于计费点：

1）若为固定金额（配置计费点）消费模式，需要在游众工具上添加计费点，

计费点信息：

1.商品编码：游众计费点编号，从0开始

2.waresid：计费点编码，须与渠道后台配置时填写的计费点编码对应

3.商品名称：用户要支付的道具或者虚拟货币名称，如：金豆

4.订单描述：对于商品的描述

5.价格（单位分）：计费点的道具价格

6.count：数量

计费点商品名称要与在酷派申请所填参数一致，例如申请参数为60钻石则在游众工具也填60钻石。在调用支付接口时，对应商品名称和价格也要和申请参数一致。

例如：SFOnlineHelper.pay(MainActivity.this, 600, "60钻石", 1,"购买钻石", CP_PAY_SYNC_URL, new SFOnlinePayResultListener()

SFOnlineHelper.charge(MainActivity.this, "60钻石", 600, 1,"购买钻石", CP_PAY_SYNC_URL, new SFOnlinePayResultListener()

2）若选择酷派的传入金额消费模式，无需使用计费点，使用支付拓展接口，调用实例：详情可参考demo。

 public static void payExtend(Context context, int unitPrice,
	String unitName, String itemCode, String remain, int count,
	String callBackInfo, String callBackUrl,
	SFOnlinePayResultListener payResultListener)

该接口用于支付扩展接口函数。在支付时，可以设置不定额支付时，不同商品的兑换比例，此时游众工具上设置的商品兑换比例无效。

参数描述:

参数名称	类型	注释
context	Context	上下文Activity
unitPrice	int	游戏道具价格，单位为人民币分
unitName	String	虚拟货币名称
itemCode	String	传入酷派后台获取的计费点编码waresid
remain	String	自定义参数。
count	int	用户选择购买道具界面的默认道具数量。（总价为 count*unitPrice）
callBackInfo	String	由游戏开发者定义传入的字符串，会与支付结果一同发送给游戏服务器，游戏服务器可通过该字段判断交易的详细内容（金额角色等）
callBackUrl	String	将支付结果通知给游戏服务器时的通知地址url，交易结束后，系统会向该url发送http请求，通知交易的结果金额callbackInfo等信息
payResultListener	SFOnlinePayResultListener	支付回调接口

四、常见问题

1. 关于渠道SDKID

酷派的渠道SDKID：{5F9E9900-D9CCC2D0}游众服务器同步回调的SDKID格式为：5F9E9900D9CCC2D0

2. 登陆和支付界面是否支持横竖屏切换？

登陆界面和支付界面都支持。

3.如何切换账号

调用logout接口登出，然后调用login接口登陆，完成账号切换的处理。