Google Pay 付款處理常式設定

這份參考資料是以通用商務通訊協定 (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,
        "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 環境中會遭到忽略。商家 ID 是顯示在 Google Pay 和錢包主控台商家名稱旁的數字或英數字元值。
merchant_info.merchant_name 字串 選用 商家面向使用者的名稱。
merchant_info.merchant_origin 字串 選用 結帳時所在的完整網域 (格式：hostname)。
merchant_info.auth_jwt 字串 選用 特定整合情境的授權 JWT。
allowed_payment_methods object[ ] 必填 這筆交易允許的付款方式。
allowed_payment_methods[].type 字串 必填 支援的付款方式類型。支援的值：CARD、EWALLET。
allowed_payment_methods[].parameters 物件 選用 設定CARD付款方式時所需的參數。如果 type 為 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.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 的必要參數如下： DIRECT 的DIRECT必要參數如下：
  • protocolVersion：Google Pay 憑證中預期的加密和簽章通訊協定版本。系統僅支援 ECv2。詳情請參閱「付款資料密碼編譯機制」。
  • publicKey：Base64 編碼的橢圓曲線公開金鑰。詳情請參閱「加密公開金鑰格式」一節。
allowed_payment_methods[].processing_specification 物件 選用 定義處理付款所需的資訊。如果 type 為 EWALLET，則必須提供這項屬性。
allowed_payment_methods[].processing_specification.type 字串 必填 電子錢包服務供應商類型。支援的值：SHOPEE_PAY、TOUCH_N_GO。
allowed_payment_methods[].processing_specification.parameters 物件 必填 所選電子錢包服務供應商專用的參數。

必要參數如下：
  • ewallet_merchant_name：商家向使用者顯示的名稱。
  • ewallet_merchant_account：電子錢包或集結網站核發的商家 ID。
  • psp_transaction_reference：PSP 產生的專屬參考號碼，用於確保冪等性。