Configuración del controlador de pagos de Google Pay

Esta referencia se basa en el esquema del objeto config del gestor de pagos de Google Pay del 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,
        "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 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 y autorizables.
merchant_info objeto Obligatorio Detalles de identidad del comerciante.
merchant_info.merchant_id string Obligatorio Tu ID de comerciante de Google Pay de la Consola de Google Pay y Wallet. Esto es obligatorio para el entorno de 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 completo cualificado en el que se produce la tramitación de 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. Valores admitidos: CARD y EWALLET.
allowed_payment_methods[].parameters objeto Opcional Parámetros necesarios para configurar el método de pago CARD. Esta propiedad es obligatoria si type es CARD.
allowed_payment_methods[].parameters.allowed_auth_methods cadena[ ] Obligatorio 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 Google Wallet.
allowed_payment_methods[].parameters.allowed_card_networks cadena[ ] Obligatorio Las redes de tarjetas admitidas por el comercio. Valores admitidos: AMEX, DISCOVER, ELECTRON, ELO, ELO_DEBIT, INTERAC, JCB, MAESTRO, MASTERCARD y VISA.
allowed_payment_methods[].parameters.allow_prepaid_cards booleano Opcional Asigna el valor false si no admites tarjetas prepago. El valor predeterminado es true.
allowed_payment_methods[].parameters.allow_credit_cards booleano Opcional Defina el valor false si no admite tarjetas de crédito. El valor predeterminado es true.
allowed_payment_methods[].parameters.billing_address_required booleano Opcional Asigna el valor 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 Se necesita el formato de la dirección de facturación para completar la transacción.
  • MIN: nombre, código de país y código postal (predeterminado).
  • FULL: nombre, dirección postal, localidad, región, código de país y código postal.
  • FULL-ISO3166: nombre, dirección postal, 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 asigna el valor true si necesitas un número de teléfono para completar la transacción.
allowed_payment_methods[].tokenization_specification objeto Opcional Configuración que define cómo se te devuelven las credenciales de pago. Esta propiedad es obligatoria si type es CARD.
allowed_payment_methods[].tokenization_specification.type string Obligatorio El tipo de tokenización.
  • PAYMENT_GATEWAY: se usa si procesas pagos a través de una [pasarela admitida](/pay/api#participating-processors). Devuelve una carga útil cifrada que se debe enviar 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 Parámetros específicos de la tokenización seleccionada type.

En PAYMENT_GATEWAY, los parámetros obligatorios son los siguientes: En el caso de DIRECT, los parámetros obligatorios son los siguientes:
  • protocolVersion: versión del protocolo de cifrado 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: clave pública de curva elíptica codificada en Base64. Para obtener más información, consulta la sección Formato de clave pública de cifrado.
allowed_payment_methods[].processing_specification objeto Opcional Define la información necesaria para procesar el pago. Esta propiedad es obligatoria si type es EWALLET.
allowed_payment_methods[].processing_specification.type string Obligatorio El tipo de proveedor de cartera electrónica. Valores admitidos: SHOPEE_PAY y TOUCH_N_GO.
allowed_payment_methods[].processing_specification.parameters objeto Obligatorio Parámetros específicos del proveedor de monedero electrónico seleccionado.

Los parámetros obligatorios son:
  • ewallet_merchant_name: nombre visible del comerciante para los usuarios.
  • ewallet_merchant_account: identificador de comercio emitido por la cartera electrónica o el agregador.
  • psp_transaction_reference: número de referencia único generado por el PSP para la idempotencia.