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

このリファレンスは、Universal Commerce Protocol（UCP）の Google Pay 支払いハンドラの構成オブジェクト スキーマに基づいています。

{
  "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,
        "assurance_details_required": 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 & ウォレット コンソールで取得した Google Pay 販売者 ID。これは PRODUCTION 環境で必要です。これは省略可能であり、TEST 環境では無視されます。
merchant_info.merchant_name 文字列 省略可 ユーザーに表示される販売者の商号。
merchant_info.merchant_origin 文字列 省略可 購入手続きが行われるウェブドメインの完全修飾名（形式: hostname）。
merchant_info.auth_jwt 文字列 省略可 特定の統合コンテキストの認可 JWT。
allowed_payment_methods object[ ] 必須 この取引で許可されているお支払い方法。
allowed_payment_methods[].type 文字列 必須 サポートされているお支払い方法のタイプ。CARD のみがサポートされています。
allowed_payment_methods[].parameters オブジェクト 必須 CARD のお支払い方法を構成するために必要なパラメータ。
allowed_payment_methods[].parameters.allowed_auth_methods string[ ] 必須 カード取引を認証するためにサポートされるフィールド。
  • PAN_ONLY: Google ウォレットに登録されているカードのメインのカード番号（PAN）と有効期限を返します。
allowed_payment_methods[].parameters.allowed_card_networks string[ ] 必須 販売者がサポートしているカード ネットワーク。 サポートされている値: 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.assurance_details_required ブール値 省略可 カード保証の詳細をリクエストするには、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 オブジェクト 必須 支払い認証情報が返される方法を定義する構成。
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 の場合、必須パラメータは次のとおりです。 DIRECT の必須パラメータは次のとおりです。
  • protocolVersion: Google Pay 認証情報で要求する暗号化 / 署名プロトコルのバージョン。ECv2 のみがサポートされています。詳しくは、支払いデータの暗号方式をご覧ください。
  • publicKey: Base64 でエンコードされた楕円曲線の公開鍵。詳細については、暗号化公開鍵の形式セクションをご覧ください。