Instrumento de pago de Google Pay

Esta referencia se basa en el esquema Card Payment Instrument para el objeto del instrumento de pago que devuelve el controlador de pagos de Google Pay cuando se completa la confirmación de compra dentro del array 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
  }
}

Propiedades

Propiedad	Tipo	¿Siempre presente?	Descripción
id	string	Sí	Es un identificador único para esta instancia de instrumento de pago, asignado por la plataforma.
handler_id	string	Sí	Es el identificador único de la instancia del controlador que produjo este instrumento. Corresponde al campo id en la configuración del controlador de pagos.
type	string	Sí	Es el tipo de instrumento de pago, p.ej., card.
selected	booleano	No	Indica si el usuario seleccionó este instrumento.
display	objeto	Sí	Muestra la información del instrumento de pago.
display.brand	string	Sí	Marca o red de la tarjeta (por ejemplo, "VISA").
display.last_digits	string	Sí	Últimos 4 dígitos del número de tarjeta.
display.description	string	No	Es una descripción de la tarjeta que se muestra al usuario.
display.card_art	string	No	Es un URI a una imagen que representa la tarjeta.
billing_address	objeto	No	Es la dirección de facturación asociada a la tarjeta. Solo se devuelve si billing_address_required se estableció en true en la configuración.
billing_address.first_name	string	No	Es el nombre del contacto asociado a la dirección.
billing_address.last_name	string	No	Apellido del contacto asociado con la dirección.
billing_address.street_address	string	No	Indica la dirección,
billing_address.extended_address	string	No	Es una extensión de dirección (por ejemplo, el número de departamento o suite).
billing_address.address_locality	string	No	Es la localidad (por ejemplo, la ciudad).
billing_address.address_region	string	No	Es la región (por ejemplo, el estado o la provincia).
billing_address.postal_code	string	No	Código postal
billing_address.address_country	string	No	Es el código de país (formato ISO 3166-1 alpha-2 de 2 letras).
billing_address.phone_number	string	No	Número de teléfono. Solo se devuelve si phone_number_required se estableció en true en la configuración.
credential	objeto	No	Son los datos de tokenización seguros que devuelve Google Pay.
credential.type	string	Sí	Es el tipo de tokenización. Coincide con el tipo configurado. PAYMENT_GATEWAY: Se usa si procesas pagos a través de una pasarela compatible. DIRECT: Se usa si descifras las credenciales por tu cuenta.
credential.token	string	Sí	Es el token de credencial de pago encriptado como una cadena serializada en JSON. En el caso de PAYMENT_GATEWAY, contiene la carga útil encriptada que se pasará a tu puerta de enlace. En el caso de DIRECT, contiene los detalles de la tarjeta encriptados (requiere desencriptación con tu clave privada). Consulta la guía Criptografía de datos de pago para obtener detalles sobre el formato y el proceso de desencriptación.