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管理コンソール > システム設定 > ウェブフック設定でウェブフック送信用の共通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プラットフォームの使用国を選択してください。選択したオプションに応じて、下部のエントリが変更されます。

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ページで確認し、必要に応じて直接キャンセルします。 Terminal 3 のPaymentwallは、即時の支払いキャンセルの代わりに支払いキャンセルリクエストを送信し、キャンセルが完了したかどうかはターミナル3コンソールで確認する必要があります。

PG会社と支払い方法
- PG会社の設定で支払い方法が有効かどうかに関わらず、会社が提供するすべてのPGのリストがオプションとして提供されます。
ステータス
- PG
  - 支払い完了 - 支払いが正常に完了しました
  - 支払い失敗 - 支払い中のエラーなどにより支払いが失敗しました
  - 支払い保留 - アカウント振替などにより支払いが即時に行われていません
  - キャンセルリクエスト - 支払いのキャンセルをリクエストします
  - キャンセル完了 - 支払いが適切にキャンセルされました。端末3の支払いはキャンセルが完了したかどうか確認できません
  - キャンセル失敗 - キャンセルリクエストが失敗しました
  - 未完了 - ユーザーが支払いウィンドウを閉じるか、支払い前に「支払いをキャンセル」をクリックしたため、支払いが完了していません
- スチーム
  - 注文を受け取る
  - 支払いを受け入れる（ユーザー）
  - 支払いをキャンセルする
  - 支払いを返金する
  - 部分返金支払い
  - 不正な支払い
  - 注文詐欺
  - チャージバック詐欺
  - 支払いキャンセル失敗
総支払額: 総支払額: 進行中でない非進行条件を除くすべての検索条件の合計
購入完了数: 購入完了カウント: キャンセルを除く完了した支払いの数
総キャンセル額/キャンセル: 総キャンセル額/キャンセルカウント: キャンセルされたケースの総額と数
製品価格: プライスタイアに設定された表示通貨での製品価格
ゲーム_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）に設定されている場合にのみ表示されます。
「詳細を学ぶ」をクリックすると、コンソール > プロビジョニング > 利用規約に設定された利用規約のリンクが開きます。