乐视(手游)SDK配置说明
一、接入前的准备
1. 商务在开发者平台:http://open.letv.com/dev-web/index.html,注册您的开发者账号,申请参数AppID,AppKey,SecretKey。
2. 支付回调地址已在客户端配置,用户无需配置。
二、易接工具参数说明
SDK信息:
1. AppKey:由乐视平台分配
2. AppId:由乐视平台分配
3. SecretKey:由乐视平台分配(secretKey是用在服务器端的)
4. 当前版本号:当前乐视SDK的版本号,此版本号要填写正确乐视版本在2.0之前,请填写1.0,在2.0及2.0之后的版本请填写2.0
5.是否支持切换账号:需选择不支持,否则会被打回。
三、 注意事项
1. 包名以“.leshi”结尾。
2. 关于targetSdkVersion的问题:sdk不能低于14.
原因:有些属性不能低于sdk14,低于14的版本没有这些属性。
例如:其他账号的Button无法显示
3.SDK兼容测试只在乐视手机上做了兼容。其他手机上可能会有问题,例如:游戏可能会出现其他账号登陆界面按back键返回游戏主界面,再点击退出游戏后显示乐视登陆界面。目前这种情况乐视不作处理。
4.乐视手机可以使用手机账号登陆,其他登录方式要点击其他乐视账号登陆按钮登陆。
5.关于计费点:
1)若为固定金额(配置计费点)消费模式,需要在易接工具上添加计费点。
计费点信息:
1、商品编码:本字段不能为空
2、商品名称:购买的商品名称
3、商品描述:购买商品的描述
4、商品图片的url:商品图片的url,商品图片地址,多个地址需用,分割,图片格式为png,大小为195*195 ,支持本地图片地址,必须写入完整图片地址,格式如:/目录/名称.jpg
5、计费点信息cp自行填写。但是在调用支付接口时,对应商品名称要和工具填写参数一致。例如:易接工具商品名称填写: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 |
乐视的商品编码 |
remain |
String |
自定义参数,可传空 |
count |
int |
用户选择购买道具界面的默认道具数量。(总价为 count*unitPrice) |
callBackInfo |
String |
由游戏开发者定义传入的字符串,会与支付结果一同发送给游戏服务器,游戏服务器可通过该字段判断交易的详细内容(金额角色等) |
callBackUrl |
String |
将支付结果通知给游戏服务器时的通知地址url,交易结束后,系统会向该url发送http请求,通知交易的结果金额callbackInfo等信息 |
payResultListener |
SFOnlinePayResultListener |
支付回调接口 |
四、常见问题
1、关于渠道SDKID
乐游(手游)的渠道SDKID:{8DC30018-87058B7A}易接服务器支付回调的SDKID格式为:8DC3001887058B7A。
2、支付失败错误码对比
错误码 |
含义 |
TRADE_NOT_ALLOWED_PAY |
不允许支付 |
ILLEGAL_SIGN |
签名不正确 |
ILLEDAL_ENCRYPT |
加密不正确 |
ILLEGAL_USER |
用户ID不正确 |
ILLEGAL_EXTERFACE |
接口配置不正确 |
PARTTNER_PROTOCOL_INVALID |
商户协议无效 |
ILLEGAL_ARGUMENT |
输入参数有错误,非空参数为空等 |
EXCEED_LIMIT |
支付超限 |