360SDK网游支付服务
1.流程介绍
1. 应用调用应用服务器进行下单；
2. 应用调用360SDK支付接口；
3. 360SDK展示支付页面，引导用户完成支付流程；
a. 若调用接口时指定金额，则显示固定金额支付界面；
b. 若调用接口时不指定金额，则显示不固定金额的支付界面；
4. 支付结束或退出360SDK支付客户端界面后，360SDK客户端会返回支付结果给应用客户端的支付模块；
5. 支付成功后，360服务器回调应用服务器上的通知接口，通知支付结果；
6. (可选) 应用服务器调用360服务器端订单确认接口，验证支付通知的合法性；
2.接口介绍
2.1 支付接口【客户端调用】（必接）
功能说明：
应用调用360SDK支付接口时，360SDK弹出支付选择界面。用户在界面上完成支付。
关于应用方订单号的问题：应用方需要生成自己的订单号app_order_id，应用订单号不能重复提交，并且一个应用订单不管是否支付成功，都只能支付一次。这样做是为了避免重复支付。通知应用方加钱时，会返回应用订单号, 同时提供360订单号。
Access token由于与当前登录用户id绑定，因此可以加强支付安全性。但要注意token的时间期限（有效期为10小时）。过期后调用支付接口会失败。游戏可以引导用户重新登录.
接口示例：
注意：
1. 必选参数不能为空, 不能为0，否则支付失败。
2. 参数名，以ProtocolKeys中定义的常量为准。
/**
* 使用360SDK的支付接口
*
* @param isLandScape 是否横屏显示支付界面
* @param isFixed 是否定额支付
*/
protected void doSdkPay(final boolean isLandScape, final boolean isFixed) {
if(!isAccessTokenValid) {
Toast.makeText(SdkUserBaseActivity.this, R.string.access_token_invalid, Toast.LENGTH_SHORT).show();
return;
}
if(!isQTValid) {
Toast.makeText(SdkUserBaseActivity.this, R.string.qt_invalid, Toast.LENGTH_SHORT).show();
return;
}
// 支付基础参数
Intent intent = getPayIntent(isLandScape, isFixed);
// 必需参数，使用360SDK的支付模块。
intent.putExtra(ProtocolKeys.FUNCTION_CODE, ProtocolConfigs.FUNC_CODE_PAY);
// 可选参数，登录界面的背景图片路径，必须是本地图片路径
intent.putExtra(ProtocolKeys.UI_BACKGROUND_PICTRUE, "");
Matrix.invokeActivity(this, intent, mPayCallback);
}
/**
* 生成调用360SDK支付接口基础参数的Intent
*
* @param isLandScape 是否横屏显示登录界面
* @param isFixed 是否定额支付
*
* @return Intent
*/
protected Intent getPayIntent(boolean isLandScape, boolean isFixed) {
Bundle bundle = new Bundle();
QihooPayInfo pay = getQihooPayInfo(isFixed);
// 界面相关参数，360SDK界面是否以横屏显示。
bundle.putBoolean(ProtocolKeys.IS_SCREEN_ORIENTATION_LANDSCAPE, isLandScape);
// 可选参数，登录界面的背景图片路径，必须是本地图片路径
bundle.putString(ProtocolKeys.UI_BACKGROUND_PICTRUE, "");
// *** 以下非界面相关参数 ***
// 设置QihooPay中的参数。
// 必需参数，用户access token，要使用注意过期和刷新问题，最大64字符。
bundle.putString(ProtocolKeys.ACCESS_TOKEN, pay.getAccessToken());
// 必需参数，360账号id。
bundle.putString(ProtocolKeys.QIHOO_USER_ID, pay.getQihooUserId());
// 必需参数，所购买商品金额, 以分为单位。金额大于等于100分，360SDK运行定额支付流程； 金额数为0，360SDK运行不定额支付流程。
bundle.putString(ProtocolKeys.AMOUNT, pay.getMoneyAmount());
// 必需参数，所购买商品名称，应用指定，建议中文，最大10个中文字。
bundle.putString(ProtocolKeys.PRODUCT_NAME, pay.getProductName());
// 必需参数，购买商品的商品id，应用指定，最大16字符。
bundle.putString(ProtocolKeys.PRODUCT_ID, pay.getProductId());
// 必需参数，应用方提供的支付结果通知uri，最大255字符。360服务器将把支付接口回调给该uri，具体协议请查看文档中，支付结果通知接口–应用服务器提供接口。
bundle.putString(ProtocolKeys.NOTIFY_URI, pay.getNotifyUri());
// 必需参数，游戏或应用名称，最大16中文字。
bundle.putString(ProtocolKeys.APP_NAME, pay.getAppName());
// 必需参数，应用内的用户名，如游戏角色名。 若应用内绑定360账号和应用账号，则可用360用户名，最大16中文字。（充值不分区服，充到统一的用户账户，各区服角色均可使用）。
bundle.putString(ProtocolKeys.APP_USER_NAME, pay.getAppUserName());
// 必需参数，应用内的用户id。
// 若应用内绑定360账号和应用账号，充值不分区服，充到统一的用户账户，各区服角色均可使用，则可用360用户ID最大32字符。
bundle.putString(ProtocolKeys.APP_USER_ID, pay.getAppUserId());
// 必需参数，应用订单号，应用内必须唯一，最大32字符。
bundle.putString(ProtocolKeys.APP_ORDER_ID, pay.getAppOrderId());
// 可选参数，应用扩展信息1，原样返回，最大255字符。
bundle.putString(ProtocolKeys.APP_EXT_1, pay.getAppExt1());
// 可选参数，应用扩展信息2，原样返回，最大255字符。
bundle.putString(ProtocolKeys.APP_EXT_2, pay.getAppExt2());
Intent intent = new Intent(this, ContainerActivity.class);
intent.putExtras(bundle);
return intent;
}callback的 json数据格式：
成功返回
{error_code: 0, error_msg: "支付成功", content:""}失败返回
{error_code: 1, error_msg: "支付失败", content:""}取消返回
{error_code: -1, error_msg: "支付取消", content:""}支付正在进行
{error_code: -2, error_msg: "正在进行", content:""}access_token失效
{error_code: 4010201, error_msg: "token已失效", content:""}QT失效
{error_code: 4009911, error_msg: "登录已失效", content:""}callback示例：
/**
* 支付的回调
*/
protected IDispatcherCallback mPayCallback = new IDispatcherCallback() {
@Override
public void onFinished(String data) {
Log.d(TAG, "mPayCallback, data is " + data);
if(TextUtils.isEmpty(data)) {
return;
}
boolean isCallbackParseOk = false;
JSONObject jsonRes;
try {
jsonRes = new JSONObject(data);
// error_code 状态码： 0 支付成功， -1 支付取消， 1 支付失败， -2 支付进行中。
// error_msg 状态描述
int errorCode = jsonRes.optInt("error_code");
isCallbackParseOk = true;
switch (errorCode) {
case 0:
case 1:
case -1:
case -2: {
isAccessTokenValid = true;
String errorMsg = jsonRes.optString("error_msg");
String text = getString(R.string.pay_callback_toast, errorCode, errorMsg);
Toast.makeText(SdkUserBaseActivity.this, text, Toast.LENGTH_SHORT).show();
}
break;
case 4010201:
isAccessTokenValid = false;
Toast.makeText(SdkUserBaseActivity.this, R.string.access_token_invalid, Toast.LENGTH_SHORT).show();
break;
case 4009911:
//QT失效
isQTValid = false;
Toast.makeText(SdkUserBaseActivity.this, R.string.qt_invalid, Toast.LENGTH_SHORT).show();
break;
default:
break;
}
} catch (JSONException e) {
e.printStackTrace();
}
// 用于测试数据格式是否异常。
if (!isCallbackParseOk) {
Toast.makeText(SdkUserBaseActivity.this, getString(R.string.data_format_error),
Toast.LENGTH_LONG).show();
}
}
};2.2 支付结果通知接口–应用服务器提供接口, 由360服务器回调（必接）
应用客户端调用支付接口时, 需指定支付结果的通知回调地址notify_uri. 支付完成后, 360服务器会把支付结果以GET方式通知到此地址 (建议应用服务端接口同时支持GET和POST). 应用接收验证参数后, 给用户做游戏内充值.
应用服务端通知接口在接收到通知消息后, 需回应ok(仅返回小写ok这两个字母，不要有其它输出), 表示通知已经接收. 如果回应其他值或者不回应, 则被认为通知失败, 360会尝试多次通知. 这个机制用来避免掉单。
应用应做好接收到多次通知的准备, 防止多次加钱. 同时, 需要特别注意的是, 回应的ok表示应用已经正常接到消息, 无需继续发送通知. 它不表示订单成功与否, 或者应用处理成功与否. 对于重复的通知, 应用可能发现订单已经成功处理完毕, 无需继续处理, 也要返回ok(仅返回小写ok这两个字母，不要有其它输出). 否则, 360会认为未成功通知, 会继续发送通知.
支付结果通知的参数如下：
参数 | 必选 | 参数类型 | 最大长度 | 参数说明 | 是否参与签名 |
app_key | Y | varchar | 32 | 应用app key | Y |
product_id | Y | varchar | 36 | 应用自定义的商品id | Y |
amount | Y | int unsigned | 11 | 总价,以分为单位 | Y |
app_uid | Y | varchar | 50 | 应用分配给用户的id | Y |
app_ext1 | N | varchar | 255 | 应用扩展信息1原样返回 | Y |
app_ext2 | N | varchar | 255 | 应用扩展信息2原样返回 | Y |
user_id | Y | bigint unsigned | 20 | 360账号id | Y |
order_id | Y | bigint unsigned | 20 | 360返回的支付订单号 | Y |
gateway_flag | Y | varchar | 16 | 如果支付返回成功，返回success 应用需要确认是success才给用户加钱 | Y |
sign_type | Y | varchar | 8 | 定值 md5 | Y |
app_order_id | N | varchar | 64 | 应用订单号 支付请求时传递，原样返回 | Y |
sign_return | Y | varchar | 32 | 应用回传给订单核实接口的参数 不加入签名校验计算 | N |
sign | Y | varchar | 32 | 签名 | N |
应用接收到支付平台回调的请求，参见附录的签名算法对参数进行签名，然后和平台传递的签名sign比较，从而校验平台请求的合法性.
通知消息样例:
order_id=1211090012345678901&app_key=1234567890abcdefghijklmnopqrstuv&product_id=p1&amount=101&app_uid=123456789&app_ext1=XXX201211091985&app_order_id=order1234&user_id=987654321&sign_type=md5&gateway_flag=success&sign=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&sign_return=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
样例的签名字段排列 (列出来仅供参考, 请根据实际参数情况用程序排序产生, 不要写死在程序里)
amount, app_ext1, app_key, app_order_id, app_uid, gateway_flag, order_id, product_id, sign_type, user_id
样例的签名串
101#XXX201211091985#1234567890abcdefghijklmnopqrstuv#order1234#123456789#success#1211090012345678901#p1#md5#987654321# 应用 app_secret
2.3 订单核实接口– 服务器端接口, 应用服务器调用（选接）
1． 验证接口地址为: http://mgame.360.cn/pay/order_verify.json
2． 为了安全起见，验证参数不需要传client_id,client_secret参数，如果传了服务端会报错
3． 需要计算签名
为了防止伪造的支付成功通知, 应用可以使用本接口做通知数据的校验.把支付结果通知接口(4.2.2节)收到的通知消息里的参数, 计算签名后调用接口, 即可校验数据是否正确.
接口地址：
http://mgame.360.cn/pay/order_verify.json?参数
参数说明：
参数均来自应用加钱接口收到的支付通知消息, 原样提供即可。
如果参数提供正确, 订单核实接口返回为json格式数据.
验证成功返回
{"ret":"verified"}
验证不成功返回
{"ret":"{错误信息}"}
返回结果中可能的错误信息包括
