PG決済

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

PG支払いポリシー¶

カテゴリ	説明
言語	16の言語が利用可能 PG会社が提供する支払い画面は、各PG会社ごとに異なる言語をサポートしています。
機能	外部ウェブブラウザを通じての支払いによるサーバーベースの操作
国別サポート	PG会社がサポートする国のPG会社を公開
支払い方法	契約したPG会社の支払い方法とPG会社はコンソールで設定する必要があります
PG支払い通貨	hive_country 通貨はPG会社によってサポートされない場合があります MyCard: 台湾 (TWD)、香港 (HKD)、マレーシア (MYR)、シンガポール (SGD)、タイ (THB)、インドネシア (IDR)、フィリピン (PHP)、ベトナム (VND)、グローバル (USD)
価格階層	コンソールにアップロードする必要があります階層はPG支払いに使用され、モバイル市場には適用されません PC用のApp IDで製品を登録する際は、金額ではなく階層を設定してください各ゲームには独自の階層があり、PC用のApp IDを作成する際に基本的な階層が提供されます。
製品管理	製品価格、製品名、市場PIDなどをコンソールに登録する必要があります
返金ユーザー返済	モバイル市場と同様のサポート

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を使用してサイトを開発します。

プレワーク¶

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

PortOneを使用する場合
- IAPサーバーコールバックURLを登録し、PortOne管理コンソールでPG会社を設定します
  - PortOne管理コンソール > システム設定 > Webhook設定でWebhookを送信するための共通URLを登録します
- Webhook URL
  - 商用: https://store.withhive.com/payment/result_processing/import
  - サンドボックス: https://sandbox-store.withhive.com/payment/result_processing/import
- 注意事項
  - PortOneはサンドボックス決済テストを提供していないため、テストのための以下の方法を提案します。
  - 商用サービスとテスト用に2つのPortOneアカウントを作成します。PortOneコンソールの管理アカウントは、実際の契約に関係なくアカウントを作成できます。
  - PortOne商用アカウントに商用URLを登録し、実際のPG会社情報などをライブコンソールに登録します。
  - PortOneテストアカウントにサンドボックス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プラットフォームの使用国を選択してください。選択したオプションに応じて、下部のエントリが変更されます。

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支払い完了未処理履歴