このガイドでは、韓国のモバイル ユーザーとタブレット ユーザーに対し、Google Play の課金システムとともに代替の課金システムを自動的にレンダリングし、その結果の取引を報告する際に使用する API について説明します。これらの API を使用する前に、次の点を確認してください。
- 要件を確認し、代替の課金システムの KR プログラムに登録している。
- Play Billing Library 5.2 以降を統合している。
Google Play 請求サービス統合の推奨モジュールの残りは、デベロッパーがすでに現在の統合用に持っているモジュールと同じです。
バックエンド統合で利用するため、Google Play Developer API の統合セットアップを準備することをおすすめします。
用語
このガイドで使用する用語規則:
- 代替の課金システムの API: ユーザー選択画面をレンダリングし、デベロッパーがデベロッパーの代替の課金システムで完了した取引を報告するための API。
- 代替の課金システム: Google Play の課金システムとともに提供されるデベロッパーの代替の課金システム。
- 外部取引: Google Play の課金システム以外で行われる取引。
- 外部取引トークン: ユーザーが代替の課金システムを選択したときに、Play Billing Library を介してデベロッパーに提供されるトークン。購入の成功を Google Play に通知するためにも使用されます。
- 外部取引 ID: 取引を識別するためにデベロッパーが生成した一意の識別子。
Google Play Console の代替の課金システムの設定
KR プログラムの登録を完了したデベロッパーは、Google Play Console で代替の課金システムの設定を管理できます。
- アプリごとに、代替の課金システムの提供を有効または無効にします。
- ガイドラインに沿ってお支払い方法のロゴをアップロードします。すべての形式の仕様を確認して遵守することが重要です。このガイドラインを遵守していない形式でアップロードしたロゴは、ユーザー選択画面に代替の課金システムとして表示されません。
- 定期購入を提供する場合は、定期購入の管理リンクを提供します。

ユーザー エクスペリエンス
クライアントサイドの API により、次の機能が有効になります。
- Google Play によって、該当する情報とユーザー選択画面がレンダリングされ、管理されます。
- ユーザーが Google Play の課金システムを使用することを選択した場合、請求フローでは通常どおり Google Play の課金インターフェースが使用されます。
![]() デベロッパー アプリ |
![]() ユーザー向け情報画面(アプリ内でユーザーごとに 1 回表示されます) |
![]() 課金選択画面 |
説明のみを目的とした例です。
ユーザー向け情報画面
情報画面は、アプリ内で提供される代替の課金システムについてユーザーにわかりやすく説明し、ユーザーが情報に基づいて判断できるように選択肢を提供します。情報画面は、代替の課金システムが有効になった後、アプリでの初回購入時にユーザーに表示されます。このメッセージは、同じデバイス上のアプリで同じユーザーがそれ以降に行った購入では表示されません。
ユーザー選択画面
ユーザー選択画面には、デベロッパーの代替の課金システムと Google Play の課金システムのいずれかを使用する選択肢が表示されます。
「代替の課金システム」オプションの構造
ユーザー選択画面の「代替の課金システム」オプションには、次の UI 要素があります。
- アプリアイコン
- アプリ名
- デベロッパーが提供するお支払い方法を含む画像アセット
- 追加のインジケーター(「など」 UI 要素は画像アセットの一部ではありません)
お支払い方法の画像アセット
1 つの画像アセットは複数の支払い方法カードで構成され、このガイドラインで定義されている仕様を遵守する必要があります。
サイズ | 192 dp x 20 dp |
カードの間隔 | 8 dp |
ファイル形式 | PNG、透明な背景 |
お支払い方法のバリエーション
デベロッパーは、画像アセットに含める利用可能なお支払い方法アイコンの数を選択できます(最大 5 つ)。
他の画像やテキストを画像に含めないでください。
カードの仕様
画像アセットに含まれるお支払い方法カードは、サイズ、間隔、スタイルに関する以下のガイドラインを遵守している必要があります。
カードのサイズ | 32 dp x 20 dp |
内側のパディング | 3 dp |
輪郭 | 1 dp(内側のストロークは寸法に含まれます)、半径 2 dp、#E0E0E0 |
カードの背景 | 無地(可能であれば白) |
次のステップ
代替の課金システムの API の統合の詳細については、アプリ内統合とバックエンド統合に関する詳細なガイドをご覧ください。