Google Pay 支付方式

此参考文档基于 银行卡支付方式 架构 ，该架构适用于 Google Pay 支付 处理程序在结账完成后于 payment.instruments 数组内返回的支付方式对象。

{
  "id": string,
  "handler_id": string,
  "type": string,
  "selected": boolean,
  "display": {
    "brand": string,
    "last_digits": string,
    "description": string,
    "card_art": string
  },
  "billing_address": {
    "first_name": string,
    "last_name": string,
    "street_address": string,
    "extended_address": string,
    "address_locality": string,
    "address_region": string,
    "postal_code": string,
    "address_country": string,
    "phone_number": string
  },
  "credential": {
    "type": "PAYMENT_GATEWAY" | "DIRECT",
    "token": string
  }
}

属性

属性	类型	始终存在？	说明
id	字符串	是	此支付方式实例的唯一标识符，由平台分配。
handler_id	字符串	是	生成此支付方式的处理程序实例的唯一标识符。对应于支付处理程序配置中的 id 字段。
type	字符串	是	支付方式的类型，例如 card。
selected	布尔值	否	表示用户是否选择了此支付方式。
display	对象	是	支付方式的显示信息。
display.brand	字符串	是	银行卡品牌/网络（例如“VISA”）。
display.last_digits	字符串	是	卡号的后 4 位数字。
display.description	字符串	否	面向用户的卡片说明。
display.card_art	字符串	否	表示银行卡的图片 URI。
billing_address	对象	否	与银行卡关联的账单邮寄地址。 仅当在配置中将 billing_address_required 设置为 true 时返回。
billing_address.first_name	字符串	否	与地址关联的联系人的名字。
billing_address.last_name	字符串	否	与地址关联的联系人的姓氏。
billing_address.street_address	字符串	否	街道地址。
billing_address.extended_address	字符串	否	地址扩展信息（例如公寓号或房间号）。
billing_address.address_locality	字符串	否	地点（例如城市）。
billing_address.address_region	字符串	否	区域（例如州或省/直辖市/自治区）。
billing_address.postal_code	字符串	否	邮政编码。
billing_address.address_country	字符串	否	国家/地区代码（2 个字母，采用 ISO 3166-1 alpha-2 格式）。
billing_address.phone_number	字符串	否	电话号码。 仅当在配置中将 phone_number_required 设置为 true 时返回。
credential	对象	否	Google Pay 返回的安全令牌化数据。
credential.type	字符串	是	令牌化类型。与配置的类型一致。 PAYMENT_GATEWAY：如果您通过受支持的网关处理付款，请使用此类型。 DIRECT：如果您自行解密凭据，请使用此类型。
credential.token	字符串	是	加密的支付凭据令牌，以 JSON 序列化字符串的形式表示。 对于 PAYMENT_GATEWAY，此字段包含要传递给网关的加密载荷。 对于 DIRECT，此字段包含加密的银行卡详细信息（需要使用您的私钥进行解密）。 如需详细了解格式和解密流程，请参阅支付数据加密指南。