支付成功后的回调通知
该功能仅在梦宝谷大中华地区的简繁体平台上提供,若您的应用将要发布到其他区域,建议不要依赖于回调来实现道具的发给。
1 概述
在使用“支付交易流程”进行交易的时候,当成功close交易时,梦宝谷开放平台将会回调开发者登记在开发者网站的地址,以通知游戏服务器交易结束。(如未登记回调地址则不会调用。)
游戏服务器需要先在开发者网站注册回调URL地址,然后再处理Mobage发出的HTTP请求。
开发者只有选择“流程一:通过客户端SDK的交易流程”进行交易的时候才需要该回调功能,使用其他的交易流程时并不需要该功能
2 注册回调URL
-
在应用程序管理中,选择需要添加回调地址的应用程序。
-
在游戏控制台 - 2其他功能追加 - Bank回调设置中设置该应用的回调地址。
tip
Sandbox和Production的回调地址可分开设置,“点击切换”来选择环境。 :::
3 处理梦宝谷HTTP回调
3.1 梦宝谷HTTP请求
回调HTTP方式
POST
回调内容说明
POST /callback HTTP/1.1
Content-Type: application/json
Host: yourhost.cn
User-Agent: Mobage
{
"sign": <sign>,
"id": <transactionId>,
"user_id": <user_id>,
"state": <state>,
"items": [<bankItem>, ...],
"comment": <comment>,
"published": <published>,
"updated": <updated>
}
sign: 签名,用于验证http消息是否是从梦宝谷的服务器发过来的。
id: 交易id
user_id: 用户id
state: 交易状态,只有状态为"close"才表明这个交易成功了。
items: 交易的道具详细信息
comment: 额外信息,这是在create transaction的时候开发者填入的信息。
published: 交易创建时间
updated: 交易结束时间
示例:
POST /callback/callback.php HTTP/1.0
Host: demo.mobage.cn
X-Real-IP: 119.15.138.3
X-Forwarded-For: 119.15.138.3
Connection: close
Content-Length: 294
User-Agent: Mobage
Content-Type: application/json
{
"published":"2013-08-16T09:43:18",
"comment":"",
"user_id":"500000070",
"updated":"2013-08-16T09:43:19",
"id":"DC6C6014-D58C-3209-861D-405E63AF27A0",
"state":"closed",
"items":[
{"item":
{"imageUrl":"",
"name":"sword",
"id":"cn01",
"price":"1",
"description":"sword"},
"quantity":"1"}],
"sign":"baaacf34a7da6ca94f817c54b5355334"
}
3.2 处理HTTP请求
合法性校验
合法性校验分为两部分,IP源校验和sign校验。
IP源校验:
| Platform | IP |
|---|---|
| 梦宝谷简体平台 | 119.15.138.0/24(119.15.138.0~119.15.138.255) |
| 梦宝谷繁体平台 | 27.131.9.0/24 (27.131.9.0~27.131.9.255) |
Sign校验:
Sign的生成方式为:
合并app_id, transaction_id 及consumer_key后,使用MD5加密方式生成哈希。
use Digest::MD5 qw/md5_hex/;
my $base_string = sprintf("%s%s%s", $app_id, $transaction_id, $consumer_key);
my $sign = md5_hex($base_string);
consumer_key 请在开发者网站上获取,游戏控制台 - 1应用基本信息 - 基本信息 - Consumer Key(服务器端用)。

3.3 回调时机、确认及重试机制
在closeTransaction成功后,梦宝谷开放平台将会发起回调。
游戏服务器返回响应200的http code,即认为成功接受。其余的都认为是错误。不校验响应中body的内容。
未获得200响应的情况下,会在以下时间点再次发起回调,直至获得响应为200或者达到最大重试次数。
回调具体时间为上一次回调失败后的3 ^ n - 1秒,n为回调次数,最大为10次。
| Retry | 时间:上一次失败后?秒后 |
|---|---|
| 第一次重试 | 3 ^ 1 - 1 = 2 |
| 第二次重试 | 3 ^ 2 - 1 = 8 |
| ... | ... |
| 第十次重试 | 3 ^ 10 - 1 = 59048 |
最后一次回调约在最初回调失败后的24.6小时后,第九次回调失败后的16.4小时后。
重试机制仅在PRODUCTION环境生效。SANDBOX环境仅会回调一次,即便没有获得200响应也不会多次回调。
3.4 示例代码
PHP
<?php
//your own key / secret
$consumer_key = 'your app consumer_key';
$appid = 'you app id';
$entityBody = file_get_contents('php://input');
$rst = json_decode($entityBody,TRUE);
$transaction_id = $rst['id'];
$sign = $rst['sign'];
//ip check
$mobageip = "119.15.138";//For SC platform
$incomingip = $_SERVER['HTTP_X_REAL_IP'] ? $_SERVER['HTTP_X_REAL_IP'] : $_SERVER['REMOTE_ADDR'];
if(FALSE===stristr($incomingip, $mobageip)){
die('{"result":"ip check failed"}');
}
//sign check
$mysign = md5($appid.$transaction_id.$consumer_key);
$protocol = (isset($_SERVER['SERVER_PROTOCOL']) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0');
if ($mysign != $sign){
header($protocol . ' ' . 403);
die("Invalid request");
}
header($protocol . ' ' . 200);
//Callback successed.
//Your own source code here to handle the callback
?>
Java
历史版本
2013.08.20 第一版
2013.10.17 添加 user_id