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 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,
        "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 Es tu ID de comercio de Google Pay de la Consola de Google Pay y la Billetera de Google. Es obligatorio para el entorno PRODUCTION. Es opcional y se ignora en el entorno TEST.
merchant_info.merchant_name string Opcional Es el nombre comercial del comercio que ven los usuarios.
merchant_info.merchant_origin string Opcional Es el dominio web completamente calificado en el que se realiza la confirmación de 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. Valores admitidos: CARD, EWALLET.
allowed_payment_methods[].parameters objeto Opcional Son los parámetros necesarios para configurar la forma de pago CARD. Esta propiedad es obligatoria si type es CARD.
allowed_payment_methods[].parameters.allowed_auth_methods string[ ] 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 string[ ] 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 Establécelo en false si no admites tarjetas prepagadas. El valor predeterminado es true.
allowed_payment_methods[].parameters.allow_credit_cards booleano Opcional Establécelo en false si no admites tarjetas de crédito. El valor predeterminado es true.
allowed_payment_methods[].parameters.billing_address_required booleano Opcional Establécelo 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 Es el formato de 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, 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 Establécelo en true si necesitas un número de teléfono para completar la transacción.
allowed_payment_methods[].tokenization_specification objeto Opcional Es la 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 Es el tipo de tokenización.
  • PAYMENT_GATEWAY: Se usa si procesas pagos a través de una [puerta de enlace admitida](/pay/api#participating-processors). Devuelve una carga útil encriptada para pasar a tu PSP.
  • DIRECT: Se usa si desencriptas las credenciales por tu cuenta (requiere el cumplimiento del Nivel 1 de PCI DSS).
allowed_payment_methods[].tokenization_specification.parameters objeto Obligatorio Son los parámetros específicos del type de tokenización seleccionado.

Para PAYMENT_GATEWAY, los parámetros obligatorios son los siguientes: Para DIRECT, los parámetros obligatorios son los siguientes:
  • protocolVersion: 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: 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.
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 Es el tipo de proveedor de billetera electrónica. Valores admitidos: SHOPEE_PAY, TOUCH_N_GO.
allowed_payment_methods[].processing_specification.parameters objeto Obligatorio Son los parámetros específicos del proveedor de billetera electrónica seleccionado.

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