Configuración del controlador de pagos de Google Pay

Esta referencia se basa en el esquema del objeto de configuración del controlador de pagos de Google Pay para el Universal Commerce Protocol (UCP).

{
  "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": {
          ...
        }
      }
    }
  ]
}

Propiedades

Propiedad Tipo Necesidad Descripción
api_version integer Obligatorio Es la versión principal de la API de Google Pay. Solo se admite 2.
api_version_minor integer Obligatorio Es la versión secundaria de la API de Google Pay. Solo se admite 0.
environment string Obligatorio Es el entorno de Google Pay que se usará.
  • TEST: Credenciales de pago solo para pruebas.
  • PRODUCTION: Credenciales de pago reales y autorizables.
merchant_info objeto Obligatorio Son los detalles de identidad del comercio.
merchant_info.merchant_id string Obligatorio Tu ID de comerciante de Google Pay de Google Pay & Wallet Console. Se requiere para el entorno de PRODUCTION. Es opcional y se ignora en el entorno de TEST.
merchant_info.merchant_name string Opcional Es el nombre comercial del comercio que se muestra al usuario.
merchant_info.merchant_origin string Opcional Es el dominio web completamente calificado en el que se realiza la confirmación de la compra (formato: hostname).
merchant_info.auth_jwt string Opcional Es el JWT de autorización para ciertos contextos de integración.
allowed_payment_methods objeto[ ] Obligatorio Son las formas de pago permitidas para esta transacción.
allowed_payment_methods[].type string Obligatorio Es el tipo de forma de pago admitida. Solo se admite CARD.
allowed_payment_methods[].parameters objeto Obligatorio Son los parámetros necesarios para configurar la forma de pago CARD.
allowed_payment_methods[].parameters.allowed_auth_methods cadena[ ] Obligatorio Son los campos admitidos para autenticar una transacción con tarjeta.
  • PAN_ONLY: Devuelve el número de cuenta principal (PAN) y la fecha de vencimiento de una tarjeta registrada en la Billetera de Google.
allowed_payment_methods[].parameters.allowed_card_networks cadena[ ] Obligatorio Son las redes de tarjetas admitidas por el comercio. Valores admitidos: AMEX, DISCOVER, ELECTRON, ELO, ELO_DEBIT, INTERAC, JCB, MAESTRO, MASTERCARD, VISA.
allowed_payment_methods[].parameters.allow_prepaid_cards booleano Opcional Se establece en false si no admites tarjetas prepagadas. La ruta predeterminada es true.
allowed_payment_methods[].parameters.allow_credit_cards booleano Opcional Establécelo en false si no admites tarjetas de crédito. La ruta predeterminada es true.
allowed_payment_methods[].parameters.assurance_details_required booleano Opcional Se establece en true para solicitar los detalles de la garantía de la tarjeta.
allowed_payment_methods[].parameters.billing_address_required booleano Opcional Se establece en true si necesitas una dirección de facturación para completar la transacción.
allowed_payment_methods[].parameters.billing_address_parameters objeto Opcional Son los parámetros que configuran la dirección de facturación que se devuelve.
allowed_payment_methods[].parameters.billing_address_parameters.format string Opcional Formato de dirección de facturación requerido para completar la transacción.
  • MIN: Nombre, código de país y código postal (predeterminado).
  • FULL: Nombre, dirección, localidad, región, código de país y código postal.
  • FULL-ISO3166: Nombre, dirección, localidad, región, código de país, código postal y iso3166AdministrativeArea.
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required booleano Opcional Se establece en true si necesitas un número de teléfono para completar la transacción.
allowed_payment_methods[].tokenization_specification objeto Obligatorio Es la configuración que define cómo se te devuelven las credenciales de pago.
allowed_payment_methods[].tokenization_specification.type string Obligatorio Es el tipo de tokenización.
  • PAYMENT_GATEWAY: Se usa si procesas pagos a través de una [pasarela compatible](/pay/api#participating-processors). Devuelve una carga útil encriptada para pasar a tu PSP.
  • DIRECT: Se usa si descifras las credenciales por tu cuenta (requiere el cumplimiento del nivel 1 de PCI DSS).
allowed_payment_methods[].tokenization_specification.parameters objeto Obligatorio Son parámetros específicos de la type de tokenización seleccionada.

Para PAYMENT_GATEWAY, los parámetros obligatorios son los siguientes: Para DIRECT, los parámetros obligatorios son los siguientes:
  • protocolVersion: Es la versión del protocolo de encriptación y firma que se espera en la credencial de Google Pay. Solo se admite ECv2. Consulta Criptografía de datos de pago para obtener más información.
  • publicKey: Es la clave pública de curva elíptica codificada en Base64. Consulta la sección Formato de clave pública de encriptación para obtener más información.