Google Pay 支払いハンドラの構成

このリファレンスは、config object schema for the Google Pay payment handler Universal Commerce Protocol（UCP）に基づいています。

{
  "api_version": 2,
  "api_version_minor": 0,
  "environment": "TEST" | "PRODUCTION",
  "merchant_info": {
    "merchant_id": string,
    "merchant_name": string,
    "merchant_origin": string,
    "auth_jwt": string
  },
  "allowed_payment_methods": [
    {
      "type": "CARD",
      "parameters": {
        "allowed_auth_methods": [
          "PAN_ONLY"
        ],
        "allowed_card_networks": [
          "AMEX" | "DISCOVER" | "ELECTRON" | "ELO" | "ELO_DEBIT" | "INTERAC" | "JCB" | "MAESTRO" | "MASTERCARD" | "VISA"
        ],
        "allow_prepaid_cards": boolean,
        "allow_credit_cards": boolean,
        "billing_address_required": boolean,
        "billing_address_parameters": {
          "format": "MIN" | "FULL" | "FULL-ISO3166",
          "phone_number_required": boolean
        }
      },
      "tokenization_specification": {
        "type": "PAYMENT_GATEWAY" | "DIRECT",
        "parameters": {
          ...
        }
      },
    }
  ]
}

プロパティ

プロパティ タイプ 必要性 説明
api_version integer 必須 Google Pay API のメジャー バージョン。2 のみがサポートされています。
api_version_minor integer 必須 Google Pay API のマイナー バージョン。0 のみがサポートされています。
environment 文字列 必須 使用する Google Pay 環境。
  • TEST: テスト専用の支払い認証情報。
  • PRODUCTION: 承認可能な実際の支払い認証情報。
merchant_info オブジェクト 必須 販売者の本人確認の詳細。
merchant_info.merchant_id 文字列 必須 Google Pay & Wallet Console の Google Pay 販売者 ID。PRODUCTION 環境では必須です。TEST 環境では省略可能で、無視されます。
merchant_info.merchant_name 文字列 省略可 販売者のユーザー向けの商号。
merchant_info.merchant_origin 文字列 省略可 購入手続きが行われる完全修飾されたウェブドメイン（形式: hostname）。
merchant_info.auth_jwt 文字列 省略可 特定の統合コンテキストの認可 JWT。
allowed_payment_methods オブジェクト [ ] 必須 この取引で許可されるお支払い方法。
allowed_payment_methods[].type 文字列 必須 サポートされているお支払い方法の種類。サポートされる値: CARD、EWALLET。
allowed_payment_methods[].parameters オブジェクト 省略可 CARD お支払い方法を構成するために必要なパラメータ。type が CARD の場合は、このプロパティが必須になります。
allowed_payment_methods[].parameters.allowed_auth_methods 文字列 [ ] 必須 カード取引を認証するためにサポートされるフィールド。
  • PAN_ONLY: Google ウォレットに保存されているカードのメインのカード番号（PAN）と有効期限を返します。
allowed_payment_methods[].parameters.allowed_card_networks 文字列 [ ] 必須 販売者がサポートしているカード ネットワーク。 サポートされる値: AMEX、DISCOVER、ELECTRON、ELO、ELO_DEBIT、INTERAC、JCB、MAESTRO、MASTERCARD、VISA。
allowed_payment_methods[].parameters.allow_prepaid_cards ブール値 省略可 プリペイド カードをサポートしていない場合は、false に設定します。デフォルトは true です。
allowed_payment_methods[].parameters.allow_credit_cards ブール値 省略可 クレジット カードをサポートしていない場合は、false に設定します。デフォルトは true です。
allowed_payment_methods[].parameters.billing_address_required ブール値 省略可 取引を完了するために請求先住所が必要な場合は、true に設定します。
allowed_payment_methods[].parameters.billing_address_parameters オブジェクト 省略可 返される請求先住所を構成するパラメータ。
allowed_payment_methods[].parameters.billing_address_parameters.format 文字列 省略可 取引を完了するために必要な請求先住所の形式。
  • MIN: 名前、国コード、郵便番号（デフォルト）。
  • FULL: 名前、住所、地域、地方、国コード、郵便番号。
  • FULL-ISO3166: 名前、住所、地域、地方、国コード、郵便番号、iso3166AdministrativeArea。
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required ブール値 省略可 取引を完了するために電話番号が必要な場合は、true に設定します。
allowed_payment_methods[].tokenization_specification オブジェクト 省略可 支払い認証情報が返される方法を定義する構成。type が CARD の場合は、このプロパティが必須になります。
allowed_payment_methods[].tokenization_specification.type 文字列 必須 トークン化のタイプ。
  • PAYMENT_GATEWAY: [サポートされているゲートウェイ](/pay/api#participating-processors)を介して支払いを処理する場合に使用します。暗号化されたペイロードを PSP に渡します。
  • DIRECT: 認証情報を自分で復号する場合に使用します（PCI DSS レベル 1 の準拠が必要です）。
allowed_payment_methods[].tokenization_specification.parameters オブジェクト 必須 選択したトークン化の type に固有のパラメータ。

PAYMENT_GATEWAY の 必須 パラメータは次のとおりです:
  • gateway: ゲートウェイの名前（例: example）。
  • 特定のゲートウェイに指定されている追加のパラメータ。
DIRECT の必須 パラメータは次のとおりです。
  • protocolVersion: Google Pay 認証情報で想定される暗号化プロトコルと署名プロトコルのバージョン。ECv2 のみがサポートされています。詳しくは、支払いデータの暗号方式をご覧ください。
  • publicKey: Base64 エンコードされた楕円曲線公開鍵。詳しくは、暗号化公開鍵の形式をご覧ください。
allowed_payment_methods[].processing_specification オブジェクト 省略可 支払いの処理に必要な情報を定義します。type が EWALLET の場合は、このプロパティが必須になります。
allowed_payment_methods[].processing_specification.type 文字列 必須 eWallet プロバイダのタイプ。サポートされる値: SHOPEE_PAY、TOUCH_N_GO。
allowed_payment_methods[].processing_specification.parameters オブジェクト 必須 選択した eWallet プロバイダに固有のパラメータ。

必須 パラメータは次のとおりです。
  • ewallet_merchant_name: 販売者のユーザー向け表示名。
  • ewallet_merchant_account: eWallet またはアグリゲータが発行した販売者 ID。
  • psp_transaction_reference: PSP がべき等性のために生成した一意の参照番号。