常见问题

综合
为什么与J9九游会合作
如何使用GPAY
技术文档
新手指引
其他问题

客户在哪些国家/地区可以使用GPAY向用户收款？

J9九游会现与100多个国家的银行、电信运营商有所合作。目前覆盖全球用户超过30亿。包括印度、巴基斯坦、东南亚、中东、南美、俄罗斯等主要新兴经济体。

你们支持哪些支付渠道？

J9九游会提供运营商代扣、银行/ATM 转账、便利店现金支付、储值卡兑换、游戏点卡等众多付款渠道。

简介

GPAY中间件SDK为开发者在Android平台上提供计费的统一调用接口，开发者一点接入，全球覆盖。

适用对象及范围

适用于策划人员、系统设计人员、开发工程师和测试工程师。

详细流程请参考GPAY对接流程介绍，其中代码对接部分流程请参考下文：

注意

每个gpay_lib工程仅供对应包名的应用引用，应用包名错误将导致计费失败。
渠道号——请注意按照下面“计费初始化”说明的规则来设置。
应用工程如果有用到so，请只保留lib中armeabi目录的so文件，其它目录的so文件请去除。

使用前准备

SDK开发包包括以下几个文件与目录：

libs：需要引用的jar包

libs目录下的这几个文件：

gpaysdk.jar

gson-2.3.1.jar

libGoogleAnalyticsServices.jar

请复制libs目录下所有文件，拷贝至各自的应用工程中的libs目录下。

Eclipse

在自己项目的project.properties文件中增加如下配置：

manifestmerger.enabled=true

IntelliJ IDEA

在自己项目的iml文件（项目名.iml）中增加如下配置：

<component name="FacetManager">
 <facet type="android" name="Android">
 <configuration>
 ...
 <option name="ENABLE_MANIFEST_MERGING" value="true" />
 ...
 </configuration>
 </facet>
</component>

Android studio

在Android Studio中配置时可能会报Validates resources references inside Android XML file的错误，此时请在错误位置上加入如下代码即可

<!--suppress AndroidDomInspection -->

注：当游戏使用 unity , cocos2dx 引擎时，请解开gpay_lib项目的libs文件夹下的gpaysdk.jar，将 assets 文件夹下的内容复制到自己工程的 assets 目录下

计费初始化

在程序的application的onCreate中调用如下代码

GameGPay.getAPI().initSdk(this, "渠道号", null);

渠道号的分配分为两种情况：
渠道号只能以大写字母 C 或 M 开头，格式由 大写字母 或数字组成，最多 总计8 字符，例： CABCDEFG 。
渠道号以字母 C 开头，表示由 开发者自行 推广，后面7个字符可以由开发者自行分配，用于区分推广的渠道。
渠道号以字母 M 开头，表示由 GPAY官方 进行推广，J9九游会会分配完整的渠道号给开发者进行应用的整合。

修改AndroidManifest.xml

编译版本

请不要将targetSdkVersion设置为23或以上，这样会导致应用程序相关权限未打开

 <uses-sdk
 android:minSdkVersion="8"
 android:targetSdkVersion="19" />

需要设置application类名，并实现相应java类

application android:name="实际的extends Application的java类全名"

混淆设置

应用工程的 project.properties 中定义 proguard.config=${sdk.dir}/tools/proguard/proguard-android.txt:proguard-project.txt

proguard-project.txt 或 android\sdk\tools\proguard\proguard-android.txt 文件中增加如下混淆配置代码：

# GPay added keep class 
-keepclasseswithmembers class * { 
 native <methods>; 
} 
-keep class com.android.** { *; } 
-keep class com.google.analytics.** { *; } 
-keep class com.google.android.gms.** { *; } 
-dontwarn okio.** 
-keep class okio.** { *; } 
-keep class okhttp3.** { *; } 
-keep class com.snowplowanalytics.** { *; } 
-keep class com.umeng.analytics.** { *; } 
-keep class u.aly.** { *; } 
-keep class com.ta.utdid2.** { *; } 
-keep class com.ut.device.** { *; } 
-keepclassmembers class * { 
 public  (org.json.JSONObject); 
} 
-keepclassmembers enum * { 
 public static **[] values(); 
 public static ** valueOf(java.lang.String); 
} 
-keep public class * extends android.app.Activity 
-keep public class * extends android.app.Application 
-keep public class * extends android.app.Service 
-keep public class * extends android.content.BroadcastReceiver 
-keep public class * extends android.content.ContentProvider

如果应用工程原来不做混淆的话，再对除GpaySDK外其它所有引用的jar中的类以及应用代码类加上如下类型的混淆配置： (下面是示例，请根据实际情况添加)

-keep class 代码类的基包名即代码类共同开头的名称1.** { *; }
-keep class 代码类的基包名即代码类共同开头的名称2.** { *; }
-keep class 代码类的基包名即代码类共同开头的名称3.** { *; }

计费接口

计费提示接口（必选接口）

public void pay(Activity activity, String item, GamePayApi.PayCallback callback);

该接口用于用户触发计费进行付费行为的入口函数。合作伙伴可以在需要计费的地方调用此接口可以进行计费。

参数描述:

参数名称	类型	意义	注释
activity	Activity	PayActivity	付费页面对应的Activity
item	String	PaymentId	计费点代码, 详见"计费点信息"
callback	GamePayApi.PayCallback	Callback	计费结果的回调逻辑。

调用示例：

GameGPay.getAPI().pay(this, "ASDFGHJK", new GamePayApi.PayCallback(){
 @Override
 public void onResult(int code, String msg)
 {
 if(code == GPay.SUCCESS)
 {
 toastMessage(String.format("success(%s)", msg));
 //Please enter your code here
 }
 else { 
 toastMessage(String.format("fail(%s)", msg)); 
 //请在此处添加信息用以提示用户计费失败，失败信息请从msg中获取
 }
 }
 });

注：请注意toast、dialog等需要在主线程内执行

失败原因?

为什么测试的计费总是失败？

由于GPAY是面向海外的计费工具，所以在国内计费不会成功。请将整合完成的应用发给J9九游会，J9九游会会进行模拟环境下的计费测试。若有问题会通过邮箱或QQ等渠道进行反馈。

为什么会NO local pay data in application？

jar包和每个应用是唯一对应的，不同的jar包之间不能互换，请注意jar包不要放错

应用接入流程总览

1.应用接入流程总览 (开发者操作部分)

移动应用接入GPAY平台，简而言之需进行以下4个步骤：

加入 GPAY平台—>创建应用—>获取SDK—>提交审核—>应用上线

1.1 加入 GPAY平台

1.1.1注册开发者账号

请点击J9九游会官网页面右上角的“登录/注册”按钮,点开发者注册,填写基本信息,完成验证邮箱,即可注册成功。

1.1.2填写资料

请确认开发者资质证明是否已符合接入规范，开发者资质证明清单如下：

1.1.2完善开发者资料

1.1.2.1 J9九游会资质注册页面如下，请按要求填写：

1.1.2.2个人资质注册页面如下，请按要求填写：

1.2 提交移动应用上线

包括创建应用 → 新建计费点 → 下载 SDK → 提交应用审核 → 应用上线

1.2.1创建应用:点击”创建应用”新建应用,输入应用名称及勾选是否存在特殊内容。

应用名称要求:最多8个字符，只允许：英文字母、数字、空格。

特别说明:
应用名称要求:因短信长度限制，最多8个字符，只允许：英文字母、数字、空格。
是否存在特殊内容:如果您产品存在特殊内容，在特定地区或面向特定用户屏蔽或过滤您的内容，将会影响到您的收益。

1.2.2创建计费点:点击右上角”＋”完成新建游戏计费点,填写计费点名称,选择计费点等级及计费点说明。

特别说明:
计费点名称:因短信长度限制，最多8个字符，只允许：英文字母、数字、空格。
计费等级：“全球付”可计费国家有50多个，不同国家货币不一样，J9九游会统一了计费标准，有6个计费等级，等级越高价格越高；在不同国家的通道、运营商、计费成功率等因素长期测试下，建议用3-6等级收益较好。
计费点说明:无字符数限制。

1.2.3下载 SDK:点击”去下载 SDK”,进入应用详情页面下载 SDK