指尖开发者平台

指尖平台技术文档

WAP充值接口

提交充值平台

GET:http://47.99.156.235/cash/view/shopList.html

参数 是否必须 字段类型 例如 名称 说明
appidstring(10)82704056应用ID-平台提供
role_idstring(32)446021950071275520应用角色ID-应用提供游戏角色ID
notify_urlstring(128)通知地址充值通知地址
server_idstring(16)应用区服ID充值通知相应服务器
attachstring(512)4460219500712755201518514497404应用回调参数
sourcestring(16)zy来源
openidstring(512)66666666用户OPENID-平台提供

请求示例

GET: http://47.99.156.235/cash/view/shopList.html?appid=82704056&attach=4460219500712755201518514497404*99&role_id=446021950071275520&openid=66666666&server_id=99¬ify_url=&v=038380616577647775#

应用资料:提供游戏信息文档

附件内容里必需附带一些必要的内容:
1. 游戏名;
2. 游戏小标题;
3. 关键字;
4. 简介:
5. 图标(512*512px)
6. LOGO(500*200px)
7. 帮助文档内容或地址,如:如何查找自己的ID

以下最好是能提供就提供下:
1.图片相关图片;
2.官方介绍地址;

应用资料:提供服务器列表文档

附件内容里必需附带一些必要的内容:
1. 区;
2. 服;
3. 请求地址或IP;

游戏开放接口:用户信息查询

GET;{服务器所对应的信息URL}
参数:roleId
如:https://game.zj789.com/userinfo?roleId=money@zj789.com

查询流水

GET:https://pay.zj789.com/Account/getAccountInfo?sn=20170413142833927610

统一返回格式

返回格式:JSON
{
    err_code:0,
    data:{
        'nick':'天上有只猪在飞'
    }
}
如:https://pay.zj789.com/Account/getAccountInfo?sn=20170413142833927610

SDK下载

PHP-UTF8:https://www.zj789.com/Public/sdk/ZjSDK.zip

IOS-SDK接入流程

初始化

类名 方法名称 方法描述
ZJHYSDK + (instancetype)sharedInstance; 获取初始化实例。
- (BOOL)registerAppid:(NSString *)appid andKey:(NSString *)key; 传入申请的appid以及key, 向SDK发起注册,并返回注 册成功或失败。

登录注册模块

类名 方法名称 方法描述
LoginInterface + (instancetype)sharedLogin; 获取模块实例
- (void)loginAPI:(void (^) (void))successBlock; 向SDK发起登录请求
- (NSString *)getOpenID; 获取玩家ID
- (NSString *)getToken; 获取Token(非必要)

支付模块

- 配置信息,SDK提供PayModel类来管理理发起支付所需的必要参数

含义 参数 必填 示例
商品名称subject测试商品001
商品价格amount0.01
商品IDgood_id1
携带值attach11%7C1110000001%7Clllxxxxx
服务器IDserver_id111
角色IDrole_id1110000001
支付成功通知服务器urlnotify_urlcom.zjhy.demo

类名 方法名称 方法描述
PayMent + (instancetype)sharedPayMent; 获取初始化实例。
- (void)payAPI:(PayModel *)model with:(void (^)(PayCompleteCode code))completeBlock; 发起支付

SDK下载

正式包(仅兼容真机,可上架):http://download.zj789.com/sdk/ZJHYSDK.framework.V1.zip
测试包(兼容真机模拟器,无法上架):http://download.zj789.com/sdk/ZJHYSDK.framework.V1.test.zip

安卓-SDK接入流程

集成

将zjhysdk.aar包放入应用工程的libs目录下

在build.gradle⽂文件中添加配置
repositories {
flatDir {
dirs 'libs'
}
}
并且添加依赖
compile ‘com.squareup.okhttp3:okhttp:3.8.1'
compile ‘com.google.code.gson:gson:2.8.1'
compile (name:'zjhysdk', ext:’aar')

注册SDK

方法调用:SDKRegister.getInstance().registerSDK(context, appid, key);
功能说明:向SDK注册必要的参数,供SDK内部使用

参数名称 参数说明
Context context 上下文
String appid 申请到的appid
String key 申请到的sdkkey

登录模块

方法调用:LoginAPI.getInstance().startLogin(context);
功能说明:向SDK发起登录请求

参数名称 参数说明
Context context 上下文

成功回调:LoginAPI.getInstance().setLoginListener();

方法调用:LoginAPI.getInstance().signOut(context);
功能说明:退出登录或切换登录帐号时调用

参数名称 参数说明
Context context 上下文

支付模块

方法调用:PayAPI.getInstance().showPayView(context, payModel);
功能说明:传入商品支付信息,SDK发起⽀付宝(app)或微信⽀付(h5)

参数名称 参数说明
Context context 上下文
PayModel payModel 见下图

SDK下载

http://download.zj789.com/sdk/zjhysdk.aar.V1.0.1.zip

统计SDK接入

集成流程

iOS:
下载StatisticsSDK.framework,导入xcode工程。

Android:
下载statisticssdk.aar,放入工程的libs目录下
在build.gradle文件中添加配置
repositories {
flatDir {
dirs 'libs'
}
}
并且添加依赖
compile ‘com.squareup.okhttp3:okhttp:3.8.1'
compile ‘com.google.code.gson:gson:2.8.1'
compile (name:'statisticssdk', ext:’aar’)

注册SDK

iOS:
方法名 功能
StatisticsSDK + (nullable instancetype)sharedInstance; 获取StatisticsSDK实例
- (BOOL)registerAPPID:(NSString * _Nonnull)appid andSDKKEY:(NSString * _Nonnull)key; 使用appid,sdkkey注册SDK, 由后台申请分配获取。
- (void)eventStatisticsWithInfo:(StatisticsInfo * _Nonnull)info :(void (^ _Nullable)(StatisticsResult * _Nonnull result))resultBlock; 发起普通事件统计
- (void)roleStatisticsWithInfo:(StatisticsInfo * _Nonnull)info :(void (^ _Nullable)(StatisticsResult * _Nonnull result))resultBlock; 发起创建新角色事件统计

注:
1.StatisticsInfo封装了事件统计所需要的参数,具体参考SDK内部的注释
2.resultBlock回调返回了StatisticsResult封装,具体包括resultStatus(状态码)和resultStr(错误信息)

Android:
方法名 功能
StatisticsClass getInstance() 获取StatisticsClass实例
public Boolean registerSDK(Context context, String appid, String key) 使用context,appid,sdkkey注册SDK, 由后台申请分配获取。
public void eventStatistics(Context context, StatisticsInfo statisticsInfo) 发起普通事件统计
public void roleStatistics(final Context context, StatisticsInfo statisticsInfo) 发起创建新角色事件统计

StatisticsInfo参数说明:

充值成功通知

通知方式:POST{服务器所对应的充值反馈URL}
成功返回success 失败返回fail

参数 类型 是否必须 示例 内容 说明
server_id string(8) 001 区服ID
role_id string(16) 88888888 角色ID 游戏对应的唯一标识,可以是账号或ID等
appid string(8) 66666666 应用号
sn string(50) '201712191201584000000 订单号 平台订单号
amount float(11,2) 6.00 金额 充值金额
pay_time datetime '2017-12-20 17:37:06 支付时间 交易成功时间
openid string(8) 65436543 openid 指尖用户OPENID
attach string(256) 附加参数 附加参数,如果是游戏请求时有带,则返回之前的参数
trade_num int 1 交易数量 交易数据
good_id string(10) 4 商品标识 商品代码
source string(32) 来源 来源
sign string(32) 9E2CA2902CE1DD1BEBD07202AF6EABA6 签名 使用后台密钥加签(大写)

H5_SDK服务器对接

GET:http://47.99.156.235/h5/server/userInfo.html

参数 是否必须 字段类型 例如 名称
appidstring(10)93373270应用ID-平台提供
openidstring(512)66666666用户OPENID-平台提供
tokenstring(32)459588be616123fb610f67185799bbbf密钥
signstring(512)验签
nonce_strstring(32)32位随机码

请求示例

GET: http://47.99.156.235/h5/server/userInfo.html?appid=93373270&token=a56150d3d4062b3c4f087a0dce58c426&openid=10462765&nonce_str=3215115c4c9cdcff490583b68779a014&sign=788C508224889601CFFB9CEFA82FE2B4

签名

这个,因为时间关系,就采用微信签名算法做签名吧
!!!!最后值一定要大写!!!!
https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_3