Buy Buttonはデジタル商品販売のための包括的なソリューションです。
仕組み
ステップ 1
ステップ 2
ステップ 3
ユーザーフロー
統合フロー
Buy Buttonを統合するには、
プロジェクトの作成
- まず プロジェクト を開き、 新規プロジェクトの作成 をクリックする。
- 設定モードでは：
- ウェブフック URL を指定する。
- プロジェクトのウェブフックに署名するための秘密キーを生成する。
収益化オプション
仮想通貨
バーチャル通貨 オプションにより、ゲーム開発者はゲーム内の通貨を販売することができます。主要機能：
- ゲーム内通貨パッケージの販売
- プロモーションキャンペーンを実施する
- ゲーム内通貨のユーザー残高の管理、
- ユーザーの通貨と国の自動検出。
設定
- 仮想通貨設定に移動し、次のパラメータを設定する：
- 名前。
- 単位当たりの価格。
- 画像。
- 必要な量の仮想通貨パッケージを作成し、それぞれ次のパラメーターを設定する。
- 価格。
- 画像。
- ストアのパッケージ表示をオンにする。
ウェブフックの設定
仮想通貨を使用する際は、以下のウェブフックを実装する必要があります：
メッセージ本文なし、HTTPコード204ありの応答でウェブフックの受信を承認します。APIリファレンスから、ウェブフックについて（例など）詳しくご参照いただけます。
ウェブフックのハンドラをテストするときは、 プロジェクト設定 > ウェブフック セクションを開いてください。
レシピ
こちらのレシピは、次のような 仮想通貨 の上級機能を試すときに役立ちます：
仮想アイテム
仮想アイテムオプションにより、現金または仮想通貨でゲームコンテンツを販売することができます。主要機能：
- 実際の通貨と仮想通貨の価格を設定
- 1または複数レベルのカタログを設定
- コンテンツへのアクセス管理たとえば、一定のレベルに達したユーザーのみが特定のアイテムを利用可能にできます。
- 簡潔なアイテムカードと詳しいアイテムカードを設定
- プロモーションキャンペーンを実施する
- ゲーム内通貨のユーザー残高の管理
- ユーザーの通貨と国の自動検出
設定
- 仮想アイテムの設定を開く。
- ストアのカタログを入力：
- アイテムグループの作成。
- アイテムを作成。それぞれ次の項目を指定する：
- アイテムが属するべき1つ以上のグループ
- SKU
- 名前と短い説明文
- 実際の通貨と仮想通貨の価格
- 画像
- ストアでグループのディスプレイをオンにします。
ウェブフックの設定
仮想アイテム を使用する際は、次のウェブフックを実装する必要があります：
メッセージ本文なし、HTTPコード204ありの応答でウェブフックの受信を承認します。APIリファレンスから、ウェブフックについて（例など）詳しくご参照いただけます。
ウェブフックのハンドラをテストするときは、 プロジェクト設定 > ウェブフック セクションを開いてください。
レシピ
こちらのレシピは、次のような 仮想アイテム の上級機能を試すときに役立ちます：
ゲームキー
ゲームキーオプションにより、ゲーム開発者は直接、ゲームのウェブサイトからキーの販売やパッケージの配布ができます。ユーザーはゲームキーウィジェットを使用して、ストアにアクセスできます。主要機能：
- キーと配布用パッケージを配布するDRMプラットフォームの
- 各DRMプラットフォーム向けに作動するシステムやゲームのコンソールバージョンの選択
- 様々なDRMプラットフォームへの異なる価格の設定
- ウィジェットのサイズおよび色のテーマの設定
- 開発者へのチップの支払い
- プレオーダー
オプションは、基本もしくは高度モードのいずれかで統合できます。
基本的な統合
基本的な統合：
- 迅速な実装。
- トークンの生成やサーバーの実装が不要。
- ユーザーの事前承認を必要としないゲームにも最適。
統合には プロジェクトID パラメーターが必要です。プロジェクト設定 > ウェブフック でご確認いただけます。
モジュールの設定：
- プロジェクト設定>統合設定でトークンなしの統合をオンにする。
- プロジェクト設定>ウェブフックでウェブフックをオフにする。
- ゲームキー設定を開いて、新しいパッケージを押す。
- パッケージのパラメーターを設定：
- SKU - 固有ID
- ゲームタイトル
- ゲームの概要
- DRMとプラットフォームを選択。
- 選択したDRMの価格を設定。
- 選択したDRM用のキーをアップロード。
- ランディングページにウィジェットコードを埋め込む。
ウィジェットパラメータの基本統合用の完全なリストは、APIリファレンスを参照してください。
高度な統合
高度な統合：
統合には次のパラメータが必要です。
- マーチャントID は プロジェクト設定 > ウェブフック でご確認いただけます
- APIキー 。パラメーターは 会社設定 > APIキー で生成できます
- プロジェクトID は プロジェクト設定 > ウェブフック でご確認いただけます
- 秘密キー 。パラメーターは プロジェクト設定 > ウェブフック で生成できます
モジュールを設定：
- ゲームキー を開いて 新しいパッケージ をクリック。
- 設定パッケージのパラメーター：
- SKU - 固有識別子
- ゲームタイトル
- ゲームの短い解説
- DRMとゲームのプラットフォームを選択。
- 選択された DRM プラットフォームの価格を設定する。
- 選択したDRMプラットフォームのキーをアップロードする。
- ウィジェットコードをランディングページに追加。
ウィジェットパラメータの高度な統合用の完全なリストは、APIリファレンスを参照してください。
ウェブフックの設定
ゲームキー の高度な統合には、次のウェブフックを実装する必要があります：
メッセージ本文なし、HTTPコード204ありの応答でウェブフックの受信を承認します。APIリファレンスから、ウェブフックについて（例など）詳しくご参照いただけます。
ウェブフックのハンドラをテストするときは、 プロジェクト設定 > ウェブフック セクションを開いてください。
レシピ
こちらのレシピは、次のような ゲームキーの上級機能を試すときに役立ちます：
トークンの取得
ストアと統合するには、トークンを取得する必要があります。トークンは、ゲームやユーザーデータと支払設定を含む文字列です。
エクソラAPIは基本アクセス認証を採用しています。マーチャントIDをユーザー名、APIキーをパスワードとして指定します。
トークンの取得はこの URL から：
https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/tokenトークンのリクエスト
ストア UIに引き渡すパラメータを含めることで、HTTP POSTリクエストを変更できます。リクエストとレスポンスは両方ともJSON形式です。
以下は、エクソラ PHP SDKを使用してPHPでトークンを取得する方法のサンプルコードです。別のプログラミング言語を使用している場合は、CURLタブをクリックして CURL 例をご覧ください。
- php
- curl
<?php
use Xsolla\SDK\API\XsollaClient;
use Xsolla\SDK\API\PaymentUI\TokenRequest;
$tokenRequest = new TokenRequest($projectId, $userId);
$tokenRequest->setUserEmail('email@example.com')
->setExternalPaymentId('12345')
->setSandboxMode(true)
->setUserName('USER_NAME');
$xsollaClient = XsollaClient::factory(array(
'merchant_id' => MERCHANT_ID,
'api_key' => API_KEY
));
$token = $xsollaClient->createPaymentUITokenFromRequest($tokenRequest);
curl -v https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token \
-X POST \
-u your_merchant_id:merchant_api_key \
-H 'Content-Type:application/json' \
-H 'Accept: application/json' \
-d '
{
"user": {
"id": {
"value": "1234567"
},
"email": {
"value": "email@example.com"
}
},
"settings": {
"project_id": 14004,
"mode": "sandbox"
}
}'パラメータの完全なリストはAPI リファレンスをご参照ください。
支払い処理のテスト
支払い処理をテスト方法：
- サンドボックスを使用
- 実際の支払いを行い、パブリッシャーアカウント経由で払い戻し
エクソラ サンドボックスは独立した環境で、実際の決済を除くライブ環境のすべての機能をサポートします。サンドボックスにアクセスするには、トークンを取得する際に "mode":"sandbox" を送信します。
銀行カードでの支払いのテスト:
- サンドボックスモードでストアを開く。
- 購入するアイテムを選択。
- 支払い方法のグループからクレジット/デービットカード を選択します。
- 銀行カードの詳細情報を入力します。その他のフィールドに任意の値を入力。正しくない情報（カード番号、有効期限、CVV等）を入力して、エラーを生成することもできます。
実際の支払いで支払い処理をテストするなら、クレジットカードの使用をおすすめします：
- ストアを開く。
- 購入するアイテムを選ぶ。
- 決済メソッドのクレジット/デビットカードのグループを選択。
- 有効なクレジットカードの詳細情報を入力。
- 決済完了後、パブリッシャーアカウントの取引検索セクションを開く。
- テスト取引を選択して、払い戻しをクリック（取引のステータスは完了になっています）。
ストアのオープン
ストアUIを新しいウィンドウで開くには、次のリンクを使用します：https://secure.xsolla.com/paystation2/?access_token=ACCESS_TOKEN、そこでACCESS_TOKENは前のステップで取得したトークンです。テストの目的で、次のURLを使用します：https://sandbox-secure.xsolla.com/paystation2/?access_token=ACCESS_TOKEN。
プロモーションオプション
クーポン
クーポン機能を使うと、パートナーはクーポンコードのついたクーポンキャンペーンを作成できます。このコードは、パートナーがアップロードする、もしくは、パブリッシャー・アカウントから生成することが可能です。ユーザーはクーポンを使って、仮想通貨や仮想アイテム、サブスクリプションプランの体験期間を受け取れます。必要に応じて、交換回数と有効期限を変更してください。
ラベル
ラベル機能を使うと、パートナーは仮想アイテムや仮想通貨パッケージのプロモーションにラベルを貼れます。例えば、「お買い得」などです。
ボーナス
ボーナス機能によって、ユーザーは何かを購入するとボーナスアイテムを受け取れます。ボーナスに指定できるのは次のものです。
- 仮想通貨
- サブスクリプションの体験期間
- 仮想アイテム
- ゲーム
- 物品（例：グッズ）
レシピ
こちらのレシピは、次のようなBuy Buttonの上級機能を試すときに役立ちます：
- 仮想通貨用の仮想アイテムを販売する
- ユーザー属性によるカタログを作成する
- 地域販売制限
- 開発者へのヒント
- キー販売制限
- 友達への贈り物
- 高度化の不正対策
- ユーザーデータストレージ
- キャッシュキオスクを介したゲーム内通貨を販売する
- 先行予約
- ボーナス
- クーポン
- ラベル
- アップグレード
- ストアAPI統合
- 資格システム