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 integer 必填 Google Pay API 的主要版本。仅支持 2。
api_version_minor integer 必填 Google Pay API 的次要版本。仅支持 0。
environment string 必填 要使用的 Google Pay 环境。
  • TEST：仅用于测试的支付凭据。
  • PRODUCTION：真实且可授权的支付凭据。
merchant_info object 必填 商家的身份详细信息。
merchant_info.merchant_id string 必填 Google Pay & Wallet Console 中的 Google Pay 商家 ID。这是 PRODUCTION 环境的必填项。在 TEST 环境中，此属性是可选的，系统会忽略它。
merchant_info.merchant_name string 可选 面向用户的商家名称。
merchant_info.merchant_origin string 可选 结账发生的完全限定 Web 网域（格式：hostname）。
merchant_info.auth_jwt string 可选 用于某些集成上下文的授权 JWT。
allowed_payment_methods object[ ] 必填 此交易允许使用的支付方式。
allowed_payment_methods[].type string 必填 支持的支付方式的类型。支持的值：CARD、EWALLET。
allowed_payment_methods[].parameters object 可选 配置 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 boolean 可选 如果您不支持预付卡，请将此属性设为 false。默认值为 true。
allowed_payment_methods[].parameters.allow_credit_cards boolean 可选 如果您不支持信用卡，请将此属性设为 false。默认值为 true。
allowed_payment_methods[].parameters.billing_address_required boolean 可选 如果您要求提供账单邮寄地址才能完成交易，请将此属性设为 true。
allowed_payment_methods[].parameters.billing_address_parameters object 可选 用于配置返回的账单邮寄地址的参数。
allowed_payment_methods[].parameters.billing_address_parameters.format string 可选 完成交易所需的账单邮寄地址格式。
  • MIN：姓名、国家/地区代码和邮政编码（默认）。
  • FULL：姓名、街道地址、市行政区、区域、国家/地区代码和邮政编码。
  • FULL-ISO3166：姓名、街道地址、市行政区、区域、国家/地区代码、邮政编码和 iso3166AdministrativeArea。
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required boolean 可选 如果您要求提供电话号码才能完成交易，请将此属性设为 true。
allowed_payment_methods[].tokenization_specification object 可选 用于定义如何向您返回支付凭据的配置。如果 type 为 CARD，则必须提供此属性。
allowed_payment_methods[].tokenization_specification.type string 必填 令牌化类型。
  • PAYMENT_GATEWAY：如果您通过 [受支持的网关](/pay/api#participating-processors)处理付款，请使用此值。返回要传递给您的 PSP 的加密载荷。
  • DIRECT：如果您自行解密凭据（需要符合 PCI DSS 1 级标准），请使用此值。
allowed_payment_methods[].tokenization_specification.parameters object 必填 特定于所选令牌化 type 的参数。

对于 PAYMENT_GATEWAY，必填 参数包括：
  • gateway：网关的名称（例如 example）。
  • 为您的特定网关指定的任何其他参数。
对于 DIRECT，必填 参数包括：
  • protocolVersion：Google Pay 凭据中应该会显示的加密和签名协议版本。仅支持 ECv2。如需了解详情，请参阅付款数据加密。
  • publicKey：Base64 编码的椭圆曲线公钥。如需了解详情，请参阅加密公钥格式部分。
allowed_payment_methods[].processing_specification object 可选 定义处理付款所需的信息。如果 type 为 EWALLET，则必须提供此属性。
allowed_payment_methods[].processing_specification.type string 必填 电子钱包提供商类型。支持的值：SHOPEE_PAY、TOUCH_N_GO。
allowed_payment_methods[].processing_specification.parameters object 必填 特定于所选电子钱包提供商的参数。

必填 参数包括：
  • ewallet_merchant_name：面向用户的商家显示名称。
  • ewallet_merchant_account：电子钱包或聚合商颁发的商家 ID。
  • psp_transaction_reference：PSP 生成的唯一参考编号，用于实现幂等性。