Forma de pago de Google Pay

Esta referencia se basa en el esquema Card Payment Instrument (Instrumento de pago con tarjeta) del objeto de instrumento de pago devuelto por el gestor de pagos de Google Pay al completar la compra en el 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í	Identificador único de esta instancia de la forma de pago, asignado por la plataforma.
handler_id	string	Sí	Identificador único de la instancia del controlador que ha generado este instrumento. Corresponde al campo id de la configuración del controlador de pagos.
type	string	Sí	El tipo de forma de pago, por ejemplo, card.
selected	booleano	No	Indica si el usuario ha seleccionado este instrumento.
display	objeto	Sí	Muestra la información de la forma de pago.
display.brand	string	Sí	La 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	Descripción de la tarjeta para los usuarios.
display.card_art	string	No	URI de una imagen que representa la tarjeta.
billing_address	objeto	No	La dirección de facturación asociada a la tarjeta. Solo se devuelve si billing_address_required se ha definido como true en la configuración.
billing_address.first_name	string	No	Nombre del contacto asociado a la dirección.
billing_address.last_name	string	No	Apellido del contacto asociado a la dirección.
billing_address.street_address	string	No	Dirección postal.
billing_address.extended_address	string	No	Una extensión de la dirección (por ejemplo, el número de apartamento o de oficina).
billing_address.address_locality	string	No	La localidad (por ejemplo, la ciudad).
billing_address.address_region	string	No	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	El código de país (formato ISO 3166-1 alfa-2 de 2 letras).
billing_address.phone_number	string	No	El número de teléfono. Solo se devuelve si phone_number_required se ha definido como true en la configuración.
credential	objeto	No	Los datos de tokenización seguros devueltos por Google Pay.
credential.type	string	Sí	El tipo de tokenización. Coincide con el tipo configurado. PAYMENT_GATEWAY: se usa si procesas los pagos a través de una pasarela compatible. DIRECT: se usa si descifras las credenciales tú mismo.
credential.token	string	Sí	El token de credencial de pago cifrado como una cadena serializada en JSON. En PAYMENT_GATEWAY, se incluye la carga útil cifrada que se debe enviar a tu pasarela. En el caso de DIRECT, contiene la información de la tarjeta cifrada (requiere descifrado con tu clave privada). Consulta la guía Criptografía de datos de pago para obtener información detallada sobre el formato y el proceso de descifrado.