支払いを設定する

Last updated on July 15, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要​

AccelByte Gaming Services (AGS) に含まれる支払いサービスでは、リアルマネーとバーチャル通貨の両方でトランザクションを実行でき、Adyen、Xsolla、Stripe、PayPal、AliPay、WxPay、およびウォレットサービスと連携できます。支払いサービスには再試行の仕組みが用意されており、支払い処理中に通知が届かなくなることを防ぎます。この再試行の仕組みは、クライアントが受信を確認するか、最大再試行回数に達するまで、失敗した通知を再送信し続けます。

AGS Public Cloud

支払いサービス機能は、AGS Public Cloud ではまだサポートされていません。

AGS の支払いサービスには、支払い処理をサポートするいくつかの機能があります。

  • リアルマネーとバーチャル通貨。 1つの支払いサービスで、ゲームやアドオンのリアルマネーでの購入と、AccelByte コインを使用したゲーム内アイテムやブースターの購入の両方をカバーできます。
  • 複数の支払いプロバイダーのサポート。 当社の支払いサービスは、Adyen、Xsolla、Stripe の決済アグリゲーターと連携でき、PayPal、Visa、Mastercard、AliPay、WxPay からの支払いを受け付けることができます。
  • 支払いアカウント管理。 Admin Portal では、決済アグリゲーターを設定し、受け付ける支払いの種類を管理できます。
  • カスタマイズされた支払いステーション。 ブランドを強調するために、支払いステーションの見た目を変更できます。
  • メール通知。 プレイヤーは、トランザクションが成功した際にメールで確認を受け取ります。

目標​

  • Adyen、Xsolla、Stripe、および Checkout の Admin Portal での支払い設定方法を詳しく説明します。
  • 支払い方法の管理方法を詳しく説明します。

前提条件​

  • AccelByte Admin Portal へのアクセス
  • 適切なネームスペースが作成されていること

支払い方法を設定する​

Adyen​

  1. 発行者ネームスペースで、Online > Wallets & Payment > Payment Configurations に移動します。

  2. New Configuration ボタンをクリックします。

    Adyen 用の新しい設定ボタンをクリックする

  3. 必須フィールドに入力します。

    Adyen 用の新しい設定を追加する

    • 支払い設定の Namespace を選択します。必要であればすべてのネームスペースを選択できます。
    • 支払い設定の Region を選択します。必要であればすべてのリージョンを選択できます。
    • Payment Aggregator のドロップダウンリストから Adyen を選択します。
    • Payment Methods フィールドは空のままにしても構いません。
    • TaxJar を使用する場合は、TaxJar Integration オプションを有効にします。Production と Sandbox API Token フィールドは、グローバル TaxJar 設定が存在する場合、自動的に入力されます。Production API Token の値を、このネームスペースで使用したい TaxJar アカウントのトークンに変更します。グローバルの Sandbox API Token を使用することも、独自のものを使用することもできます。

  4. 完了したら、Submit ボタンをクリックすると Payment Configuration ページにリダイレクトされます。

  5. 新しく作成した支払い設定で、Payment Aggregator セクションに移動し、Configure Now ボタンをクリックします。

    Adyen 用の Configure Now ボタンをクリックする

  6. 必須フィールドに入力します。

    Adyen 用の設定を入力する

    • Adyen の API Key を入力します。
    • Adyen の Merchant Account を入力します。
    • Notification Hmac Key を入力します。
    • Notification Username と Password を入力します。
    • Return URL を入力します。
    • Live Endpoint URL Prefix を入力します。
    • Authorize as Capture を有効にするかどうかを選択します。

  7. 完了したら、Add をクリックして設定を保存します。

Adyen Drop-In SDK を設定する​

Adyen の Checkout Web SDK の段階的廃止の決定 を受けて、AccelByte は Drop-in への移行 を進めています。現在 Checkout Web SDK を使用している場合は、以下の手順に従って移行してください。

  1. Adyen Payment Configuration Details ページで、Payment Aggregator (ADYEN) までスクロールし、Drop-In Setting タブをクリックします。これらの設定を好みに応じて調整します。設定の全リストと説明については、Adyen の optional configuration ガイドを参照してください。

    Adyen Drop-In Setting タブを設定する

Xsolla​

  1. 発行者ネームスペースで、Online > Wallets & Payment > Payment Configurations に移動します。

  2. New Configuration ボタンをクリックします。

    Xsolla 用の新しい設定ボタンをクリックする

  3. 必須情報を入力します。

    Xsolla 用の新しい設定を追加する

    • 支払い設定の Namespace を選択します。必要であればすべてのネームスペースを選択できます。
    • 支払い設定の Region を選択します。必要であればすべてのリージョンを選択できます。
    • Payment Aggregator のドロップダウンリストから Xsolla を選択します。
    • Payment Methods フィールドは空のままにしても構いません。

  4. Submit をクリックして続行します。Payment Configuration ページにリダイレクトされます。

  5. Payment Aggregator セクションの Xsolla タブで、必須情報を入力します。

    Xsolla 用の支払い設定の詳細を入力する

    • Xsolla の Merchant ID を入力します。
    • Xsolla の Project ID / プロジェクト番号を入力します。
    • Xsolla の Project Secret Key を入力します。
    • Xsolla の API Key を入力します。
    • 以下のように、適切な形式で Completion URL を入力します。
      • 開発環境: https://dev.example.accelbyte.io/paymentCallback
      • 本番環境: https://example.com/paymentCallback

  6. Test ボタンをクリックし、Xsolla configured correctly の通知が表示されることを確認します。

    Xsolla が正しく設定されたことを示す通知

Stripe​

  1. 発行者ネームスペースで、Online > Wallets & Payment > Payment Configurations に移動します。

  2. New Configuration ボタンをクリックします。

    Stripe 用の新しい設定ボタンをクリックする

  3. 必須フィールドに入力します。

    Stripe 用の新しい設定を追加する

    • 支払い設定の Namespace を選択します。必要であればすべてのネームスペースを選択できます。
    • 支払い設定の Region を選択します。必要であればすべてのリージョンを選択できます。
    • Payment Aggregator のドロップダウンリストから Stripe を選択します。
    • Payment Methods フィールドは空のままにしても構いません。
    • TaxJar を使用する場合は、TaxJar Integration オプションを有効にします。Production と Sandbox API Token フィールドは、グローバル TaxJar 設定が存在する場合、自動的に入力されます。Production API Token の値を、このネームスペースで使用したい TaxJar アカウントのトークンに変更します。グローバルの Sandbox API Token を使用することも、独自のものを使用することもできます。

    完了したら、Submit ボタンをクリックすると Payment Configuration ページにリダイレクトされます。

  4. Payment Aggregator セクションで、Configure Now をクリックします。

    Stripe 用の Configure Now ボタンをクリックする

  5. 必須フィールドに入力します。

    • Stripe ダッシュボードから取得したキーを Publishable Key フィールドに入力します。
    • Stripe ダッシュボードから取得したキーを Secret Key フィールドに入力します。
    • Stripe ダッシュボードから取得したシークレットを Webhook Secret フィールドに入力します。

    Stripe 用の設定を入力する

  6. Test ボタンをクリックし、Stripe has been configured correctly の通知を受け取ることを確認します。

    プレースホルダー

Checkout​

  1. 発行者ネームスペースで、Online > Wallets & Payment > Payment Configurations に移動します。

  2. New Configuration ボタンをクリックします。

    Checkout 用の新しい設定ボタンをクリックする

  3. 必須フィールドに入力します。

    Checkout 用の新しい設定を追加する

    • 支払い設定の Namespace を選択します。必要であればすべてのネームスペースを選択できます。
    • 支払い設定の Region を選択します。必要であればすべてのリージョンを選択できます。
    • Payment Aggregator のドロップダウンリストから Checkout を選択します。
    • Payment Methods フィールドは空のままにしても構いません。
    • TaxJar を使用する場合は、TaxJar Integration オプションを有効にします。Production と Sandbox API Token フィールドは、グローバル TaxJar 設定が存在する場合、自動的に入力されます。Production API Token の値を、このネームスペースで使用したい TaxJar アカウントのトークンに変更します。グローバルの Sandbox API Token を使用することも、独自のものを使用することもできます。

  4. Payment Aggregator セクションで、Configure Now ボタンをクリックします。

    Checkout 用の Configure Now ボタンをクリックする

  5. 設定フォームが表示されます。必須情報を入力します。

    • checkout.com の Public Key を入力します。
    • checkout.com の Secret Key を入力します。

    Checkout 用の設定を入力する

    支払い設定を入力すると、Payment Configuration Details に移動します。Test ボタンをクリックして、決済アグリゲーターの設定が機能していることを確認できます。

    Checkout が正しく設定されたことを示す通知

Neon Pay​

注記

Neon Pay の支払い設定のサポートは、まだベータ段階です。

  1. 発行者ネームスペースで、Online > Wallets & Payment > Payment Configurations に移動します。

  2. Payment Configurations ページで、+ New Configuration ボタンをクリックします。

  3. Add New Configuration フォームに、必須情報を入力します。

    • 支払い設定を利用可能にするゲームネームスペースを選択します。すべてのゲームネームスペースに支払い設定を適用したい場合は、All Namespaces オプションも利用できます。
    • 支払い設定を適用するリージョンを選択します。すべてのリージョンに支払い方法を適用したい場合は、All Regions オプションも利用できます。
    • Payment Aggregator のドロップダウンから NEONPAY を選択します。
    • Payment Methods フィールドで、該当する支払い方法を選択します。これは空欄のままでも構いません。

  4. Submit をクリックして続行します。Neon Pay の支払い方法の詳細ページが表示されます。

  5. Payment Aggregator セクションの Neonpay Setting タブで、本番環境とテスト（サンドボックス）環境の両方の設定を行うオプションがあります。設定したい環境の Configure now ボタンをクリックします。ポップアップで、Neon Pay から取得した API キーと Webhook Secret Key を追加します。その後、Add をクリックします。

  6. Test ボタンをクリックして、Neon Pay の設定をテストします。AGS はページの右上部分に通知を表示し、設定が正しいかどうかを示します。

支払い方法を管理する​

決済アグリゲーターを設定した後、サポートする支払い方法も設定できます。

  1. Admin Portal で、Payment Configurations Details に移動し、Payment Methods パネルまでスクロールします。

    Admin Portal の支払い方法パネルに移動する

  2. Payment Methods セクションで、支払い方法を選択し、必須情報を入力します。

    • AliPay の場合：

      • AliPay プラットフォームの App ID を入力します。
      • Private Key を入力します。
      • Public Key を入力します。
      • Return URL を入力します。

    • AliPay Sandbox の場合：

      • AliPay Sandbox プラットフォームの App ID を入力します。
      • Private Key を入力します。
      • Return URL を入力します。
      • Public Key を入力します。

    • WxPay の場合：

      • WxPay プラットフォームの App ID を入力します。
      • Key を入力します。
      • MCHID を入力します。
      • Return URL を入力します。
      • Upload ボタンをクリックして、コンピューター上のファイルを検索し、Certificate AWS Path をアップロードします。
      • Return URL を入力します。

    • PayPal の場合：

      • PayPal プラットフォームの Client ID を入力します。
      • Client Secret を入力します。
      • Webhook ID を入力します。
      • Return URL を入力します。

    • PayPal Sandbox の場合：

      • PayPal プラットフォームの Client ID を入力します。
      • Client Secret を入力します。
      • Webhook ID を入力します。
      • Return URL を入力します。

完了したら、Test ボタンをクリックして支払い設定をテストします。

支払いメタデータの履歴​

Admin Portal では、詳細な支払いメタデータの履歴を確認できます。

  1. Admin Portal で、Online > Wallets & Payment > Sales > Payment Metadata に移動します。

  2. ここでは、ゲームネームスペース内のすべての支払いメタデータ履歴のリストを確認できます。特定の支払いの詳細を確認するには、選択したメタデータの Action 列にある View をクリックします。

    支払いメタデータリストで View をクリックする

  3. Metadata List が表示されます。ここで、選択したメタデータの詳細情報を確認できます。

    メタデータの詳細

TaxJar 連携​

一部の国や地域では、デジタル商品の販売時に売上税を徴収する必要があります。税法は、購入するプレイヤーが住んでいる州、市、あるいは地区によって異なる場合があります。これらさまざまな規制に準拠するために、税処理サービスを利用できます。AGS は TaxJar との連携をサポートしており、オンライン購入に対する売上税を自動的に計算・適用するために使用できます。

TaxJar との連携により、オンライン購入に対する売上税の適用方法を設定できます。Admin Portal で作成できる設定には、2つの種類があります。

  • Global Configurations は、すべてのネームスペースおよび支払い設定にわたるすべての購入に適用されます。
  • TaxJar の Specific Configurations は、特定の支払い設定または特定のゲームネームスペースにのみ適用されます。

これは、ゲームのパブリッシャーとデベロッパーが別々の TaxJar アカウントを持っている場合や、異なるリージョンに拠点を置いている場合に使用できます。この方法では、パブリッシャーの TaxJar アカウントがグローバル設定に使用されている場合でも、ゲーム内で行われるオンライン販売については、デベロッパーの TaxJar アカウントを使用して売上税を計算することができます。

現在、TaxJar はアメリカ合衆国 (US) で公開されているオンラインストアでのみ有効にできます。以下のチュートリアルに従って、グローバルまたは特定の TaxJar 連携を作成してください。

グローバル税設定を作成する​

  1. Admin Portal の Payment Configuration ページで、TaxJar Integration タブに切り替えます。

    支払い設定ページの TaxJar Integration タブ

  2. TaxJar Integration タブで、連携を enable に切り替えます。

    TaxJar 連携を有効にする

  3. TaxJar Configuration フォームに入力します。

    TaxJar 設定フォーム

  4. 次に、各アイテムタイプの横にある鉛筆アイコンをクリックし、商品コードを入力して、TaxJar Product Codes Mapping パネルで各アイテムタイプに適切な TaxJar 商品コードを追加します。デジタル商品の場合、商品税コードは 31000 です。TaxJar コードのリストは TaxJar のドキュメント で確認することもできます。

    支払い設定の TaxJar コードマッピング

特定の税設定を作成する​

  1. Admin Portal の Payment Configuration ページで、New Configuration ボタンをクリックします。

    特定の税用の新しい設定ボタンをクリックする

  2. 表示された Add New Configuration フォームに、必須情報を入力します。

特定の税用の新しい設定を追加する

  • Single Namespace オプションを選択し、ドロップダウンメニューから、この設定を適用するゲームネームスペースを選択します。
  • 支払い設定を適用する Region を選択します。現在、TaxJar は US で行われるオンライン購入にのみ使用できます。
  • ドロップダウンメニューから使用する Payment Aggregator を選択します。
  • 使用する Payment Methods を選択します。このフィールドは任意です。
  • TaxJar Integration オプションを有効にします。Production と Sandbox API Token フィールドは、グローバル TaxJar 設定が存在する場合、自動的に入力されます。Production API Token の値を、このネームスペースで使用したい TaxJar アカウントのトークンに変更します。グローバルの Sandbox API Token を使用することも、独自のものを使用することもできます。

完了したら、Submit をクリックします。

特定の設定が Payment Configuration Details ページに追加されます。

特定の設定の詳細ページ

グローバルまたは特定の TaxJar 設定を行った後、TaxJar アカウントを使用して、ゲームおよびパブリッシングプラットフォームで行われたオンライン購入に対して売上税を計算・適用します。

TaxJar の税計算を含む支払いページの例

に最終更新
On this page