PG決済

PG決済はPCとモバイルで使用できます。

PG支払いポリシー¶

PG決済プロセス¶

① ゲーム内ストアで購入する商品を選択します

② ゲーム画面の外にあるウェブビューで支払い方法選択画面を表示する

• 言語: ゲーム言語
• 通貨: hive_country SDKが配信する通貨。存在しない場合は、IPによって国が確認され、その国の通貨として表示される
• 支払いのための製品名は、Console > Billing > IAP v4 > Market PID Management に表示される。表示される言語に製品名がない場合、英語の製品名に入力された内容が表示される。
• 支払い方法の設定は、Console > Billing > PG Payment Settings > PG Company Settings で行うことができる

③ PG会社の国に対する支払いページを呼び出し、ウェブブラウザで表示する

• 支払い対象国でない場合はエラーページが表示される

④ 支払いが完了したら、完了ページに移動する。完了ページはブラウザの言語で表示される。

ウェブストアにおけるPG決済の実装¶

商品を販売するウェブサイトを構築する際は、以下の手順に従ってください。

① コンソール > アプリセンターに移動して、2つのAppIDを発行します。

• ウェブログイン用のAppID
  • ウェブログインAppIDを選択
  • 使用目的をウェブサイトとして選択
  • ウェブサイト用に発行された既存のAppIDがある場合は、既存のものを使用することもできます。
• 支払い用のAppID
  • ゲームAppIDを選択
  • OSを選択 – Windows、マーケット – 直接配信

② ウェブログインのAppIDの詳細を設定します。

• すべてのIdPキー値をログイン情報に入力してください
• ログインIdPの使用を設定してください
• ログイン後に戻るサイトアドレスをウェブログインアクション設定のリダイレクトURIに入力してください

③ コンソール > 請求 > 支払い環境設定 > PG会社設定に移動して、PG会社情報を登録します。

④ ステップ1で作成した支払いAppIDにマーケットPIDを登録するには、コンソール > 請求 > アプリ内支払い > マーケットPIDを登録に移動します。

⑤ ウェブログインAPIとウェブPG決済APIを使用してサイトを開発します。

• WebログインAPIに移動
• Web PG決済APIに移動

事前作業¶

1. PG決済プラットフォーム設定¶

• PortOneを使用する場合
  • PortOne管理コンソールでIAPサーバーコールバックURLを登録し、PG会社を設定します
    • PortOne管理コンソール > システム設定 > ウェブフック設定でウェブフック送信のための共通URLを登録します
  • ウェブフックURL
    • 商用: https://store.withhive.com/payment/result_processing/import
    • サンドボックス: https://sandbox-store.withhive.com/payment/result_processing/import 
  • 注意事項
    • PortOneはサンドボックス決済テストを提供していないため、テストのための以下の方法を提案します。
    • 商用サービスとテスト用に2つのPortOneアカウントを作成します。PortOneコンソールの管理アカウントは、実際の契約に関係なくアカウントを作成できます。
    • 商用アカウントに商用URLを登録し、実際のPG会社情報などをライブコンソールに登録します。
    • テストアカウントにサンドボックスURLを登録し、テストPG会社情報などをサンドボックスコンソールに登録します。
    • 商用サービスの目的で実際のPortOneアカウントが1つだけ使用されている場合、初回申請時にサンドボックスに接続し、公式サービス用に商用URLに変更します。
    • 商用URLに変更した後はサンドボックスアドレスに変更しないでください。実際のユーザーの支払いはテスト支払いとして処理されることに注意してください。
    • PortOneコンソールがPG会社をテストに設定すると、取引履歴は翌日に自動的にキャンセルされます。商用サービスのゲームはテストに設定してはいけません。
• Xsollaを使用する場合
  • プラットフォームビジネスオフィスにサブプロジェクトの作成をリクエストし、プロジェクトIDとシークレットキーを発行します
• 直接契約を通じてMyCardを使用する場合
  • コンソール > PG会社設定に移動し、サービス国としてMyCardを選択してハッシュキーを生成します。
  • コンソールから発行されたハッシュキーとIP、URL、および顧客会社登録情報をMyCardが提供する登録フォームに入力し、MyCardに提出します。以下の添付ファイルからIPとURL情報をダウンロードしてください。IP & URL情報をダウンロード
  • その後、MyCardからFaServiceIDを受け取り、コンソールのPG会社設定に入力します。
  • 注意事項
    • 最低および最高の支払い額は各決済方法の通貨に応じて指定されているため、製品価格設定には注意してください。
    • 適用価格範囲外の製品の支払いをリクエストするとエラーメッセージが表示されます。

2. コンソール設定¶

• 価格階層設定
  • メニューの場所: コンソール > 請求 > ストア価格管理 > 価格階層
  • 価格階層設定ガイドのショートカット
• マーケットPIDの登録
  • メニューの場所: コンソール > 請求 > アプリ内購入 > マーケットPID登録
  • マーケットPID登録ガイドのショートカット
• PG支払い設定
  • メニューの場所: コンソール > 請求 > 支払い環境設定 > PG会社設定
  • PG会社設定ガイドのショートカット

PG会社設定ガイド¶

ゲームで使用するPG会社を設定します。設定が完了すると、PG会社は削除できず、非アクティブにすることのみが可能です。

① ゲームを選択: 選択したPG会社を確認するためにゲームを検索します。ゲームリストが表示されない場合は、ゲームの権限を確認してください。

② ゲームを追加: PG会社の設定ページに移動します。

③ 国別の支払い方法を表示: ポップアップで設定したPG会社の国別の支払い方法を確認してください。

④ 修正: 登録されたPG会社の詳細を修正します。

ゲームによるPG会社の登録

ゲーム追加ボタンをクリックして、登録ページに移動してください。

① 支払い結果を受け取るためのURL: 支払い完了通知を受け取りたい場合は、サーバーのURLを入力してください。

② 支払い完了通知タイプ: 支払い完了通知を設定する際に通知タイプを選択します。デフォルトオプションは「支払い成功情報のみを送信」です。「すべて送信」を選択した場合、通知を受信するサーバーは支払い成功およびキャンセルタイプのための分岐ロジックを設定しておく必要があります。

③ PGプラットフォームによるサービス国: 各PGプラットフォームがサービスを提供する国を選択できます。以下の入力フィールドは、選択したオプションに基づいて変更されます。MyCardの場合、PortOneやXsollaを使用せずに直接サービス契約がある場合のみ選択してください。サービス国を変更すると、以前に入力した情報は削除され、以前のサービス国に戻すために詳細を再入力する必要があります。

1. PortOneを設定する

• PortOne情報: I'mportコンソールシステム設定に登録されている同じ情報を入力してください。サブショップがある場合は、ティアコードを入力する必要があります。直接契約を通じてNaver Payと連携する場合は、チェーンIDの値を入力する必要があります。
• PortOne - PG会社の支払い方法: PortOne管理者コンソールに設定されているPG会社のリストが自動的に読み込まれます。使用する支払い方法を選択する際は、PG IDを確認し、KCPの場合はPortOne管理コンソールと同様に有効化してください。各PG IDによって有効化された支払い方法がPortOne管理者コンソールと異なる場合、正しく表示されません。横スクロールバーを最右に移動すると、設定した支払い方法のプレビューを表示するボタンが見えます。PG契約のための支払いテストページが必要な場合は、プレビューページのURLをコピーしてPG会社に提供してください。

2. Xsollaの設定

• Xsolla情報: プロジェクトIDとWebhook秘密鍵をXsollaコンソール>プロジェクト設定>一般設定にコピーして入力します。
• Xsolla - PG会社の支払い方法: 各サポートされている国の支払い方法を選択します。プレビューをクリックすると、国に関係なくすべてのXsollaの有効化された支払い方法が表示されます。

3. MyCardの設定

• MyCard情報: MyCardが提供するFaServiceIDを入力します。認証番号（ハッシュ）キーは自動的に生成されます。生成されたHASH KEYをコピーし、MyCard登録リクエストフォームに記入してMyCardに提出します。
• MyCard - PG会社の支払い方法: 支払い方法としてMyCardのみが提供されます。

PC決済の問い合わせとキャンセル¶

PortOneまたはXsollaのすべての決済詳細を1ページで確認し、必要に応じて直接キャンセルします。 ターミナル3 のPaymentwallは、即時の決済キャンセルの代わりに決済キャンセルリクエストを送信し、キャンセルが完了したかどうかはターミナル3のコンソールで確認する必要があります。

• PG会社と支払い方法
  • PG会社の設定で支払い方法が有効になっているかどうかに関わらず、会社が提供するすべてのPGのリストがオプションの選択肢として提供されます。
• ステータス
  • PG
    • 支払い完了 - 支払いが正常に完了しました
    • 支払い失敗 - 支払い中のエラーなどにより支払いが失敗しました
    • 支払い保留 - アカウント振替などの理由で支払いが即座に行われていません
    • キャンセルリクエスト - 支払いのキャンセルをリクエストします
    • キャンセル完了 - 支払いが適切にキャンセルされました。端末3の支払いは、キャンセルが完了したかどうかを確認できません
    • キャンセル失敗 - キャンセルリクエストが失敗しました
    • 未完了 - ユーザーが支払いウィンドウを閉じるか、支払い前にキャンセル支払いをクリックしたため、支払いが完了していません
  • スチーム
    • 注文を受け取る
    • 支払いを受け入れる（ユーザー）
    • 支払いをキャンセルする
    • 支払いを返金する
    • 部分返金支払い
    • 不正な支払い
    • 注文詐欺
    • チャージバック詐欺
    • 支払いキャンセル失敗
• 総支払額: 総支払額: 進行中でない検索条件を除いたすべての合計
• 購入完了数: 購入完了カウント: キャンセルを除いた完了した支払いの数
• 総キャンセル額/キャンセル: 総キャンセル額/キャンセルカウント: キャンセルされたケースの総額と数
• 商品価格: プライスタイアで設定された表示通貨での商品の価格
• Game_Payload_info: アイテム支払い結果送信APIを通じてAnalyticsで追加指標として使用されるゲームサーバーから受け取った値
• IAP_Payload: アプリ開発者によって自己定義された購入メタデータ
• 注意事項
  • 変更前の設定値を持つコンソールの支払い履歴は、PG会社の設定でオプション値を変更するとキャンセルできません。
    • 例1: PG会社の設定でXsollaからPortOneに切り替えた場合、既存のXsolla支払いデータはコンソールでキャンセルできません。
    • 例2: ティアコードが使用された時点からの支払い履歴は、PG会社の設定でティアコードが使用され、その後削除された場合、コンソールでキャンセルできません。
  • I'mportコンソールで支払い詳細を直接キャンセルした場合、PG会社によってはキャンセル詳細がコンソールに送信されないことがあるため、代わりにパネルを通じてキャンセルを試みてください。

PC決済アイテム再処理¶

このメニューでは、正常に完了していないPG決済の詳細を確認できます。再送信をクリックして、決済プロセスを完了し、購入した商品を支払います。再送信が成功すると、検索結果から消えます。

• メニューの場所: コンソール > 請求 > IAP v4 > PG決済完了未処理履歴

カリフォルニア州デジタルメディア消費者保護法（AB 2426）への準拠¶

• カリフォルニア州の「デジタルメディア消費者保護法（AB 2426）」の施行により、消費者にデジタルコンテンツの購入を実際には所有していないことを通知することが義務付けられています。このポリシーを反映した通知は、PG支払いUIに表示されます。このメッセージは、国がアメリカ合衆国に設定され、言語が英語（en）に設定されている場合にのみ表示されます。
• 「詳細を学ぶ」をクリックすると、コンソール > プロビジョニング > 利用規約に設定された利用規約のリンクが開きます。