Configuración del controlador de pagos de Google Pay

Esta referencia se basa en el esquema del objeto de configuración para el controlador de pagos de Google Pay para el protocolo de comercio universal (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 Número entero Obligatorio La versión principal de la API de Google Pay. Solo se admite 2.
api_version_minor Número entero Obligatorio La versión secundaria de la API de Google Pay. Solo se admite 0.
environment string Obligatorio El entorno de Google Pay que se va a usar.
  • TEST: credenciales de pago solo para pruebas.
  • PRODUCTION: credenciales de pago reales que se pueden autorizar.
merchant_info objeto Obligatorio Detalles de identidad del comerciante.
merchant_info.merchant_id string Obligatorio Tu ID de comerciante de Google Pay en la Consola de Google Pay y Wallet. Es obligatorio para el entorno PRODUCTION. Es opcional y se ignora en el entorno TEST.
merchant_info.merchant_name string Opcional El nombre comercial del comerciante que se muestra a los usuarios.
merchant_info.merchant_origin string Opcional El dominio web cualificado donde se realiza la compra (formato: hostname).
merchant_info.auth_jwt string Opcional JWT de autorización para determinados contextos de integración.
allowed_payment_methods objeto[ ] Obligatorio Los métodos de pago permitidos para esta transacción.
allowed_payment_methods[].type string Obligatorio El tipo de método de pago admitido. Solo se admite CARD.
allowed_payment_methods[].parameters objeto Obligatorio Parámetros necesarios para configurar el método de pago CARD.
allowed_payment_methods[].parameters.allowed_auth_methods string[ ] Obligatorio Campos admitidos para autenticar una transacción con tarjeta.
  • PAN_ONLY: devuelve el número de cuenta principal (PAN) y la fecha de caducidad de una tarjeta registrada en Google Wallet.
allowed_payment_methods[].parameters.allowed_card_networks string[ ] Obligatorio Las redes de tarjetas admitidas por el comerciante. Valores admitidos: AMEX, DISCOVER, ELECTRON, ELO, ELO_DEBIT, INTERAC, JCB, MAESTRO, MASTERCARD y VISA.
allowed_payment_methods[].parameters.allow_prepaid_cards booleano Opcional Define este valor como false si no admites tarjetas prepago. El valor predeterminado es true.
allowed_payment_methods[].parameters.allow_credit_cards booleano Opcional Define este valor como false si no admites tarjetas de crédito. El valor predeterminado es true.
allowed_payment_methods[].parameters.assurance_details_required booleano Opcional Define este valor como true para solicitar los detalles de seguridad de la tarjeta.
allowed_payment_methods[].parameters.billing_address_required booleano Opcional Define este valor como true si necesitas una dirección de facturación para completar la transacción.
allowed_payment_methods[].parameters.billing_address_parameters objeto Opcional Parámetros que configuran la dirección de facturación devuelta.
allowed_payment_methods[].parameters.billing_address_parameters.format string Opcional Formato de la dirección de facturación necesario para completar la transacción.
  • MIN: nombre, código de país y código postal (predeterminado).
  • FULL: nombre, dirección postal, localidad, provincia o estado, código de país y código postal.
  • FULL-ISO3166: nombre, dirección postal, localidad, provincia o estado, código de país, código postal y iso3166AdministrativeArea.
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required booleano Opcional Define este valor como true si necesitas un número de teléfono para completar la transacción.
allowed_payment_methods[].tokenization_specification objeto Obligatorio Configuración que define cómo se te devuelven las credenciales de pago.
allowed_payment_methods[].tokenization_specification.type string Obligatorio El tipo de tokenización.
  • PAYMENT_GATEWAY: se usa si procesas los pagos a través de una [pasarela admitida](/pay/api#participating-processors). Devuelve una carga útil cifrada que se debe enviar a tu proveedor de servicios de pago.
  • DIRECT: se usa si descifras las credenciales tú mismo (requiere el cumplimiento del nivel 1 del PCI DSS).
allowed_payment_methods[].tokenization_specification.parameters objeto Obligatorio Parámetros específicos del type de tokenización seleccionado.

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