跳到主要内容

アイテムを課金する

次に Payment API を利用して課金アイテムを購入するプログラムを開発していきます。

注意

Android ゲームポイント対応に伴い、Shell App Framework for Android の場合、仮想通貨は『ゲームポイント』となります。詳細は以下 URL をご確認ください。

https://docs.mobage.com/display/JPSA/AndroidGPShellApp

課金アイテムの購入を開始する​

まずはじめに、課金アイテムの購入を開始するための画面を開発します。

以下のような payment_start.php を開発します。

<?php
require_once ('OAuth.php');
require_once ('validator.php');

// Validate Request from Gadget Server
$valid = RequestValidator::validate();
if (!$valid) {
// Respond Error Page
print('<html><body><p>Invalid Request from Gadget Server</p></body></html>');
exit ;
}
?>
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width" />
</head>
<body style="margin:0; text-align:center;">
<br>
<a href="#" onclick="mobage.shellapp.Service.showBankUI();">Click to Buy MobaCoin</a>
<br>
<a href="?url=http%3A%2F%2Fdev.gameserver.com%2Fpayment_confirm.php">Click to Buy Sample Item</a>
</body>
</html>

前章と同様に、validator.php の ResuestValidator クラスを利用して、Gadget サーバーからのリクエストの妥当性検証を行います。

require_once ('OAuth.php');
require_once ('validator.php');

// Validate Request from Gadget Server
$valid = RequestValidator::validate();
if (!$valid) {
// Respond Error Page
print('<html><body><p>Invalid Request from Gadget Server</p></body></html>');
exit ;
}

次に、HTML部分です。

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width" />
</head>
<body style="margin:0; text-align:center;">
<br>
<a href="#" onclick="mobage.shellapp.Service.showBankUI();">Click to Buy MobaCoin</a>
<br>
<a href="?url=http%3A%2F%2Fdev.gameserver.com%2Fpayment_confirm.php">Click to Buy Sample Item</a>
</body>
</html>

Shell App Framework では、モバコインを購入するダイアログの表示は、JavaScript の API として提供されています。後述するプラットフォーム側の決済画面上でモバコインの残高が不足している場合も、モバコイン購入への導線がありますが、アプリケーション内に配置したい場合は、mobage.shellapp.Service.showBankUI() を使用します。

アイテム購入のためには、Payment API を呼び出す必要がありますので、次の payment_confirm.php で詳説します。ここでは、payment_confirm.php へのリンクを追加してきます。

決済トランザクションを開始する​

次に、Payment API を利用して Payment エントリを作成し、課金アイテムの詳細を表示する画面を開発します。

以下のような payment_confirm.php を開発します。

<?php
require_once ('OAuth.php');
require_once ('validator.php');

// Validate Request from Gadget Server
$valid = RequestValidator::validate();
if (!$valid) {
// Respond Error Page
print('<html><body><p>Invalid Request from Gadget Server</p></body></html>');
exit ;
}

// Consumer Key from DevSite (or DevPortal)
$consumer_key = 'YourConsumerKey';
// Consumer Secret from DevSite (or DevPortal)
$consumer_secret = 'YourConsumerSecret';
// OAuth Consumer
$consumer = new OAuthConsumer($consumer_key, $consumer_secret, NULL);

// Request from Gadget Server
$request_from_gadget = OAuthRequest::from_request(NULL, NULL, NULL);
// opensocial_viewer_id from Gadget Server
$user_id = $request_from_gadget -> get_parameter('opensocial_viewer_id');
// Token from Gadget Server
$token_from_gadget = new OAuthToken($request_from_gadget -> get_parameter('oauth_token'), $request_from_gadget -> get_parameter('oauth_token_secret'));

// EndPoint URL for Payment API
$url = "http://sb.sp.app.mbga.jp/api/restful/v1/payment/@me/@self/@app?xoauth_requestor_id=$user_id";
// HTTP Method
$method = 'POST';
// Parse Parameters
parse_str(parse_url($url, PHP_URL_QUERY), $params);
// Request to API Server
$request_to_API = OAuthRequest::from_consumer_and_token($consumer, $token_from_gadget, $method, $url, $param);
// Generate OAuth Signature
$request_to_API -> sign_request(new OAuthSignatureMethod_HMAC_SHA1(), $consumer, $token_from_gadget);
// Create Authorization Header
$auth_header = $request_to_API -> to_header();

// POST Body with Payment Entry
$payment_entry = array(
'callbackUrl' => 'http://dev.gameserver.com/payment_callback.php',
'finishUrl' => 'http://dev.gameserver.com/payment_finish.php',
'entry' => array(
array(
'itemId' => 12,
'name' => 'Sample Item',
'unitPrice' => 100,
'amount' => 3,
'description' => 'This is a sample transaction',
'imageUrl' => 'https://dev.gameserver.com/img/item/12.gif'
)
)
);
$body = json_encode($payment_entry);

// Execute HTTP Request to API Server
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $body);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_ENCODING , "gzip");
curl_setopt($curl, CURLOPT_HTTPHEADER, array($auth_header));
$response = curl_exec($curl);
$status_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

// Check Response from API Server
if ($status_code != 201) {
// Respond Error Page
print("<html><body><p>Got an error from API Server ($status_code, $response)</p></body></html>");
exit ;
}

// Parse JSON in Response
$payment = json_decode($response);
$payment_id = $payment -> {'payment'} -> {'id'};
$status = $payment -> {'payment'} -> {'status'}; // Always 0
$entry = $payment -> {'payment'} -> {'entry'};
$item_id = $entry[0] -> {'itemId'};
$name = $entry[0] -> {'name'};
$unit_price = $entry[0] -> {'unitPrice'};
$amount = $entry[0] -> {'amount'};
$total = $unit_price * $amount;
$endpoint_url = $payment -> {'payment'} -> {'endpointUrl'};

// Store Payment Data into DataBase
// ex) INSERT INTO payment (payment_id, user_id, item_id, amount, total, status, item_given) VALUES ($payment_id, $user_id, $item_id, $amount, $total, $status, 0);

?>
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width" />
</head>
<body style="margin:0; text-align:center;">
<p>Do you want to buy following item?</p>
<br>
<p>Item Name: <?=$name ?></p>
<p>Item Price: <?=$unit_price ?></p>
<p>Amount: <?=$amount ?></p>
<p>Total: <?=$total ?></p>
<a href="<?=$endpoint_url ?>">Buy</a>
<br>
<br>
<a href="?url=http%3A%2F%2Fdev.gameserver.com%2Fpayment_start.php">Cancel</a>
</body>
</html>

プログラムの処理を説明をしてきます。

はじめのGadget サーバーからゲームサーバーへのリクエストの妥当性検証は前章と同様ですので割愛します。

次に、API サーバーへのアクセスの準備をします。まずは、API サーバー OAuth のパラメーターに必要な、Consumer KeyとConsumer Secretを準備します。また、Payment API へのPOSTメソッドは Proxy モデル (OAuth のトークンを利用するモデル) を使用しますので、Gadget サーバーから渡される、OAuth のトークンと opensocial_viewer_id (画面を閲覧しているログインユーザーのID) を取得します。

// Consumer Key from DevSite (or DevPortal)
$consumer_key = 'YourConsumerKey';
// Consumer Secret from DevSite (or DevPortal)
$consumer_secret = 'YourConsumerSecret';
// OAuth Consumer
$consumer = new OAuthConsumer($consumer_key, $consumer_secret, NULL);

// Request from Gadget Server
$request_from_gadget = OAuthRequest::from_request(NULL, NULL, NULL);
// opensocial_viewer_id from Gadget Server
$user_id = $request_from_gadget -> get_parameter('opensocial_viewer_id');
// Token from Gadget Server
$token_from_gadget = new OAuthToken($request_from_gadget -> get_parameter('oauth_token'), $request_from_gadget -> get_parameter('oauth_token_secret'));

必要な情報が揃ったので、OAuth のヘッダー情報を生成します。Payment エントリを作成するためのパスである /payment/@me/@self/@app を Sandbox 用の Endpoint URL を基準に作成します。Proxy モデルの場合は、リクエストパラメーターの xoauth_requestor_id に 上記で取得した opensocial_viewer_id の値を設定します。

// EndPoint URL for Payment API
$url = "http://sb.sp.app.mbga.jp/api/restful/v1/payment/@me/@self/@app?xoauth_requestor_id=$user_id";
// HTTP Method
$method = 'POST';
// Parse Parameters
parse_str(parse_url($url, PHP_URL_QUERY), $params);
// Request to API Server
$request_to_API = OAuthRequest::from_consumer_and_token($consumer, $token_from_gadget, $method, $url, $param);
// Generate OAuth Signature
$request_to_API -> sign_request(new OAuthSignatureMethod_HMAC_SHA1(), $consumer, $token_from_gadget);
// Create Authorization Header
$auth_header = $request_to_API -> to_header();

次に、Payment エントリの情報を含む JSON 形式の POST データを準備します。Array 形式で callbackUrl (決済完了通知用の URL) と finishUrl (決済終了画面用の URL) および課金アイテムの情報を設定し、json_encode 関数で JSON 形式に変換します。callbackUrl および finishUrl に設定した URL に対するプログラムの実装は後述します。

// POST Body with Payment Entry
$payment_entry = array(
'callbackUrl' => 'http://dev.gameserver.com/payment_callback.php',
'finishUrl' => 'http://dev.gameserver.com/payment_finish.php',
'entry' => array(
array(
'itemId' => 12,
'name' => 'Sample Item',
'unitPrice' => 100,
'amount' => 3,
'description' => 'This is a sample transaction',
'imageUrl' => 'https://dev.gameserver.com/img/item/12.gif'
)
)
);
$body = json_encode($payment_entry);

上記で生成された OAuthの Authorization ヘッダーおよび POST データを利用して API サーバーへのリクエストを実行します。API サーバーからのレスポンスデータと HTTP ステータスコードを取得しておきます。

// Execute HTTP Request to API Server
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $body);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_ENCODING , "gzip");
curl_setopt($curl, CURLOPT_HTTPHEADER, array($auth_header));
$response = curl_exec($curl);
$status_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

Payment API の POST メソッドでは、成功時には HTTP ステータスコードは 201 が返ります。ここでは、201 以外の場合はエラー画面を返すようにしておきます。

// Check Response from API Server
if ($status_code != 201) {
// Respond Error Page
print("<html><body><p>Got an error from API Server ($status_code, $response)</p></body></html>");
exit ;
}

HTTP ステータスが 201 の場合は、レスポンスデータに含まれる JSON データを解析して、 Payment エントリの値を取り出します。このチュートリアルでは実装しませんが、status が 0 の状態でDB等にPaymentのデータをストアします。

最後に課金アイテムの情報をHTMLに埋め込みます。また、プラットフォーム側の決済画面のURLが含まれる endpoint 値をリンク先に埋め込みます。

// Parse JSON in Response
$payment = json_decode($response);
$payment_id = $payment -> {'payment'} -> {'id'};
$status = $payment -> {'payment'} -> {'status'}; // Always 0
$entry = $payment -> {'payment'} -> {'entry'};
$item_id = $entry[0] -> {'itemId'};
$name = $entry[0] -> {'name'};
$unit_price = $entry[0] -> {'unitPrice'};
$amount = $entry[0] -> {'amount'};
$total = $unit_price * $amount;
$endpoint_url = $payment -> {'payment'} -> {'endpointUrl'};

// Store Payment Data into DataBase
// ex) INSERT INTO payment (payment_id, user_id, item_id, amount, total, status, item_given) VALUES ($payment_id, $user_id, $item_id, $amount, $total, $status, 0);

?>
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width" />
</head>
<body style="margin:0; text-align:center;">
<p>Do you want to buy following item?</p>
<br>
<p>Item Name: <?=$name ?></p>
<p>Item Price: <?=$unit_price ?></p>
<p>Amount: <?=$amount ?></p>
<p>Total: <?=$total ?></p>
<a href="<?=$endpoint_url ?>">Buy</a>
<br>
<br>
<a href="?url=http%3A%2F%2Fdev.gameserver.com%2Fpayment_start.php">Cancel</a>
</body>
</html>

決済確定通知を受け取る​

次に、Payment エントリ作成時に callbackUrl で指定した決済確定通知を受け取るプログラムを開発します。このプログラムは、HTMLを表示するのではなく、プラットフォーム側に決済後に、処理が正常に行われたことを通知することが目的になります。ゲームからプラットフォームの決済画面に遷移し、ユーザーが決済を確定した直後に呼び出されます。

以下のような payment_callback.php を開発します。

<?php
require_once ('OAuth.php');
require_once ('validator.php');

// Validate Request from Platform Server
$valid = RequestValidator::validate();
if (!$valid) {
// Respond Error
header("HTTP/1.0 400 Bad Request ");
print('NG');
exit ;
}

// Getting Payment Parameters
$app_id = $_REQUEST['opensocial_app_id'];
$viewer_id = $_REQUEST['opensocial_viewer_id'];
$owner_id = $_REQUEST['opensocial_owner_id'];
$payment_id = $_REQUEST['payment_id'];
$updated = $_REQUEST['updated'];
$status = $_REQUEST['status'];

// Update Payment Status on Database
// ex) UPDATE payment SET status=$status WHERE payment_id=$payment_id AND status=0 AND item_given=0;
// If No Rows Updated, Return Error HTTP Status like 400.

if($status != 10){
// Respond Error
header("HTTP/1.0 400 Bad Request ");
print('NG');
exit ;
}

print('OK');
?>

プログラムの処理を説明をしてきます。

決済確定通知のリクエストは、Gadget サーバーではなく、プラットフォーム本体から送信されますが、Gadget サーバーからのリクエストの時と同様にリクエストの妥当性を検証します。

require_once ('OAuth.php');
require_once ('validator.php');

// Validate Request from Platform Server
$valid = RequestValidator::validate();
if (!$valid) {
// Respond Error
header("HTTP/1.0 400 Bad Request ");
print('NG');
exit ;
}

次に、決済確定通知のリクエストに付与するリクエストパラメーターをそれぞれ取得し、主に payment_id をキーにしてステータスの更新を行います。この時点では、まだアイテムの付与は確定していない状態にしておきます。このチュートリアルでは実装しませんが、ゲームサーバーのデータベースへアクセスし、payment_id から該当の Payment 情報を取得して、ステータスを確定に Update します。
この時点で開始済みのデータが存在しない場合は、重複したリクエスト等の予期しないリクエストのなので、エラーとして HTTP ステータス400等を返します。

また、リクエストパラメーターに付与されているstatusが 10 でない場合も同様に正常な決済ではないため、エラーとして HTTP ステータス400を返します。

// Getting Payment Parameters
$app_id = $_REQUEST['opensocial_app_id'];
$viewer_id = $_REQUEST['opensocial_viewer_id'];
$owner_id = $_REQUEST['opensocial_owner_id'];
$payment_id = $_REQUEST['payment_id'];
$updated = $_REQUEST['updated'];
$status = $_REQUEST['status'];

// Update Payment Status on Database
// ex) UPDATE payment SET status=$status WHERE payment_id=$payment_id AND status=0 AND item_given=0;
// If No Rows Updated, Return Error HTTP Status like 400.

if($status != 10){
// Respond Error
header("HTTP/1.0 400 Bad Request ");
print('NG');
exit ;
}

最後に処理が正常な場合はレスポンスとして、文字列の OK を返します。

print('OK');

アイテム付与の開始処理等でなんらかのエラーが発生した場合は、HTTP ステータスコードを 200 以外を返すようにしてください。購入がエラー扱いとなり、決済がキャンセルされます。

購入終了ページを表示する​

次に、Payment エントリ作成時に finishUrl で指定した購入終了ページを開発します。決済確定通知の処理が正常に終わった場合に、プラットフォームの決済画面から遷移します。ただ購入終了ページを表示するだけでなく、Payment エントリを最後に取得し、決済のステータスが完了していることを確認し、アイテム付与の確定処理を行います。

以下のような payment_finish.php を開発します。

<?php
require_once ('OAuth.php');
require_once ('validator.php');

// Validate Request from Gadget Server
$valid = RequestValidator::validate();
if (!$valid) {
// Respond Error Page
print('<html><body><p>Invalid Request from Gadget Server</p></body></html>');
exit ;
}

// Consumer Key from DevSite (or DevPortal)
$consumer_key = 'YourConsumerKey';
// Consumer Secret from DevSite (or DevPortal)
$consumer_secret = 'YourConsumerSecret';
// OAuth Consumer
$consumer = new OAuthConsumer($consumer_key, $consumer_secret, NULL);

// PaymentID from Gadget Server
$payment_id = $_REQUEST['payment_id'];
// UserID from Gadget Server
$user_id = $_REQUEST['opensocial_viewer_id'];
// ApplicationID
$app_id = 'YourApplicationID';

// EndPoint URL for Payment API
$url = "http://sb.sp.app.mbga.jp/api/restful/v1/payment/$user_id/@self/@app/$payment_id?xoauth_requestor_id=$app_id";
// HTTP Method
$method = 'GET';
// Parse Parameters
parse_str(parse_url($url, PHP_URL_QUERY), $params);
// Request to API Server
$request_to_API = OAuthRequest::from_consumer_and_token($consumer, NULL, $method, $url, $param);
// Generate OAuth Signature
$request_to_API -> sign_request(new OAuthSignatureMethod_HMAC_SHA1(), $consumer, NULL);
// Create Authorization Header
$auth_header = $request_to_API -> to_header();

// Execute HTTP Request to API Server
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_ENCODING , "gzip");
curl_setopt($curl, CURLOPT_HTTPHEADER, array($auth_header));
$response = curl_exec($curl);
$status_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

// Check Response from API Server
if ($status_code != 200) {
// Respond Error Page
print('<html><body><p>Got an error from API Server (' . $status_code . ', ' . $response . ')</p></body></html>');
exit ;
}

// Parse JSON in Response
$payment = json_decode($response);
$payment_id = $payment -> {'payment'} -> {'id'};
$status = $payment -> {'payment'} -> {'status'};

// Update Payment Status on Database
// ex) UPDATE payment SET status=$status WHERE payment_id=$payment_id AND status=10 AND item_given=0;
// If No Rows Updated, Respond Error Page

if($status != 10){
// Respond Error Page
print('<html><body><p>Invalid Payment Status</p></body></html>');
exit ;
}

// Give Item to the User on Database
// ex1) INSERT INTO item (user_id, item_id, payment_id, deleted) VALUES ($user_id, $item_id, $payment_id, 0);
// ex2) UPDATE payment SET item_given=1 WHERE payment_id=$payment_id AND status=10 AND item_given=0;
// If No Rows Updated, Respond Error Page and Rollback the Given Item

?>
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width" />
</head>
<body style="margin:0; text-align:center;">
<p>Thank you for buying the item!!</p>
<a href="?url=http%3A%2F%2Fdev.gameserver.com%2Findex.html">Go to Top</a>
</body>
</html>

プログラムの処理を説明をしてきます。

はじめに、この購入終了ページは Gadget サーバーを経由してリクエストされますので、今までと同様にリクエストの妥当性を検証します。

次に、API サーバーへのアクセスの準備をします。まずは、API サーバー OAuth のパラメーターに必要な、Consumer KeyとConsumer Secretを準備します。また、Payment API への GET メソッドは Trusted モデル (OAuth のトークンを利用しないモデル) を使用することができます。Gadget サーバーから渡される、Payment エントリの ID と opensocial_viewer_id (画面を閲覧しているログインユーザーのID) を取得します。また、Trusted モデルの場合は、アプリケーションIDも必要になりますので定義しておきます。アプリケーションIDは、デベロッパーサイト上の「アプリケーション詳細」ページで確認できますので、その値をプログラムに設定してください。必要な情報が揃ったので、OAuth のヘッダー情報を生成します。Payment エントリを取得するためのパスである /payment/{userId}/@self/@app/{paymentId} を Sandbox 用の Endpoint URL を基準に作成します。Trusted モデルの場合は、リクエストパラメーターの xoauth_requestor_id にアプリケーションIDの値を設定します。また、OAuth トークンを設定しないために、@me は使えませんので、直接ユーザーIDを指定します。

// EndPoint URL for Payment API
$url = "http://sb.sp.app.mbga.jp/api/restful/v1/payment/$user_id/@self/@app/$payment_id?xoauth_requestor_id=$app_id";
// HTTP Method
$method = 'GET';
// Parse Parameters
parse_str(parse_url($url, PHP_URL_QUERY), $params);
// Request to API Server
$request_to_API = OAuthRequest::from_consumer_and_token($consumer, NULL, $method, $url, $param);
// Generate OAuth Signature
$request_to_API -> sign_request(new OAuthSignatureMethod_HMAC_SHA1(), $consumer, NULL);
// Create Authorization Header
$auth_header = $request_to_API -> to_header();

上記で生成された OAuthの Authorization ヘッダーを利用して API サーバーへのリクエストを実行します。API サーバーからのレスポンスデータと HTTP ステータスコードを取得しておきます。

// Execute HTTP Request to API Server
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_ENCODING , "gzip");
curl_setopt($curl, CURLOPT_HTTPHEADER, array($auth_header));
$response = curl_exec($curl);
$status_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

Payment API の GET メソッドでは、成功時には HTTP ステータスコードは 200 が返ります。ここでは、200 以外の場合はエラーページを返すようにしておきます。

// Check Response from API Server
if ($status_code != 200) {
// Respond Error Page
print('<html><body><p>Got an error from API Server (' . $status_code . ', ' . $response . ')</p></body></html>');
exit ;
}

HTTP ステータスが 200 の場合は、レスポンスデータに含まれる JSON データを解析して、 status の値を取り出し、決済のステータスが 10 (成功) であることを確認します。決済ステータスが 10 の場合は、アイテム付与の確定処理を行います。このチュートリアルでは実装しませんが、ゲームサーバーのデータベースへアクセスし、該当のpayment_id レコードが未確定状態で存在することを確認してから確定状態にします。

万が一、決済ステータスが 10 以外の場合は、決済が完了していませんので、課金アイテムの付与の確定処理をしないようにします。この処理を行わないと、ユーザーが決済していないにもかかわらず、課金アイテムを付与したことになってしまいます。

// Parse JSON in Response
$payment = json_decode($response);
$payment_id = $payment -> {'payment'} -> {'id'};
$status = $payment -> {'payment'} -> {'status'};

// Update Payment Status on Database
// ex) UPDATE payment SET status=$status WHERE payment_id=$payment_id AND status=10 AND item_given=0;
// If No Rows Updated, Respond Error Page

if($status != 10){
// Respond Error Page
print('<html><body><p>Invalid Payment Status</p></body></html>');
exit ;
}

// Give Item to the User on Database
// ex1) INSERT INTO item (user_id, item_id, payment_id, deleted) VALUES ($user_id, $item_id, $payment_id, 0);
// ex2) UPDATE payment SET item_given=1 WHERE payment_id=$payment_id AND status=10 AND item_given=0;
// If No Rows Updated, Respond Error Page and Rollback the Given Item

あとは、購入が終了した旨をユーザーへ通知する画面を表示するのみです。

iOS の場合は、モバコインではなく、ゲームに特化したゲームポイントという仮想通貨を利用しますので、デベロッパーサイト上で設定が必要になります。
デベロッパーサイト上の「iOS」の画面で、「ゲームポイント名称」「ゲームポイント記号」を設定します。ここでは、MyPoint と MP と登録します。

実機で確認する​

では、開発した4つのPHPプログラムを以下のようにゲームサーバーに配置します。

PHP ファイルURL
payment_start.phphttp://dev.gameserver.com/payment_start.php
payment_confirm.phphttp://dev.gameserver.com/payment_confirm.php
payment_callback.phphttp://dev.gameserver.com/payment_callback.php
payment_finish.phphttp://dev.gameserver.com/payment_finish.php

また、前章で作成した index.html に payment_start.php へのリンクを以下のように追加して再配置してください。

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width" />
</head>
<body style="margin:0; text-align:center;">
<p>Welcome To My First Web Game!</p>
<a href="?url=http%3A%2F%2Fdev.gameserver.com%2Fmypage.php">My Page</a>
<br>
<br>
<a href="?url=http%3A%2F%2Fdev.gameserver.com%2Fpayment_start.php">Buy Something</a>
</body>
</html>

さて、前章で実機にインストールしたクライアントアプリケーションを再度起動してください。起動中の場合は、上部の Home ボタンを押してスタートページを更新してください。以下のように、Buy Something のリンクが追加されています。

Buy Something をクリックして遷移し、Click to Buy MobaCoin をタップすると、以下のようにモバコイン購入ダイアログが表示れます。Sandbox 環境では、自由にコインを付与できますので、あらかじめ購入しておきます。

Buy Something をタップして遷移し、Click to Buy Sample Item をタップすると、ゲーム内のアイテム詳細画面が表示されます。

Buy をタップすると、プラットフォーム側の決済画面に遷移します。

購入が完了すると、payment_callback.php が呼ばれた後に、payment_finish.php に遷移して決済完了です。

ヘッダのボタンからモバコイン購入ダイアログを開く​

ヘッダやフッタ内のボタンからもモバコイン購入ダイアログが表示できるようにすることができます。
前章で説明した通り、デベロッパーサイト上から「Androidアプリ設定」 > 「Layout編集」と進みます。以下のようにヘッタの右部にある Info ボタンに該当する button 要素の href 属性が、showBankUI になっています。

ヘッダの Info ボタンをタップして、モバコイン購入ダイアログが表示されることを確認します。

アイテム付与漏れの救済処理​

購入完了ページを表示する際に不具合などが発生し、決済されたにも関わらず、アイテムの付与がされていなかったケースを考慮して、救済する処理を作成する必要があります。このチュートリアルでは実装しませんが、ゲームサーバーのデータベースにストアしている決済の履歴上はアイテム付与をしていない Payment ID に対して API サーバーが返す決済のステータスが 10 ではないものが付与漏れのPayment ID となります。
例えば、以下のような SQL で抽出することが可能です。

SELECT * FROM payment WHERE status=10 AND item_given=0; // 完了しているがアイテム付与漏れの決済抽出

尚、その逆に万が一決済が完了おらずにアイテムを付与しているものを抽出する場合は、以下のような SQL になります。

SELECT * FROM payment WHERE status!=10 AND item_given=1; // 完了しておらずアイテム付与済の決済抽出

上記のようなレコードが存在する場合は、正しい状態に戻すように運用しなければなりません。

正常な状態は以下のような、SQLで抽出できるレコードになります。

SELECT * FROM payment WHERE status=10 AND item_given=1; // 正常に完了した決済の抽出
SELECT * FROM payment WHERE status=1 AND item_given=0; // エラーで終了決済の抽出
SELECT * FROM payment WHERE status=0 AND item_given=0; // キャンセルされた決済の抽出

これで、アイテムの課金のチュートリアルは完了です。

参考資料​

決済サービスの詳細はこちらを参照してください。
PaymentAPIの詳細はこちらを参照してください。
JavaScriptのshowBankUIの詳細はこちらを参照してください。

更新履歴​

  • 2013/01/10
    • 実装を堅牢なものに変更
  • 2012/12/11
    • 新規作成
  • 課金アイテムの購入を開始する
  • 決済トランザクションを開始する
  • 決済確定通知を受け取る
  • 購入終了ページを表示する
  • 実機で確認する
  • ヘッダのボタンからモバコイン購入ダイアログを開く
  • アイテム付与漏れの救済処理
  • 参考資料
  • 更新履歴