Google Pay 付款處理常式設定

本參考資料是以通用商務通訊協定 (UCP) 的 config 物件結構定義為基礎，適用於 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 整數 必填 Google Pay API 的主要版本。目前僅支援 2。
api_version_minor 整數 必填 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 的PAYMENT_GATEWAY必要參數如下： DIRECT 的必要參數如下：
  • protocolVersion：Google Pay 憑證中預期的加密和簽署通訊協定版本。目前僅支援 ECv2。詳情請參閱「付款資料密碼編譯」。
  • publicKey：採用 Base64 編碼的橢圓曲線公開金鑰。詳情請參閱「加密公開金鑰格式」一節。