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,
        "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 & 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。
allowed_payment_methods[].parameters 对象 必需 配置 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.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 编码的椭圆曲线公钥。如需了解详情，请参阅加密公钥格式部分。