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 la Consola de Google Pay y la Billetera de Google. Esto 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 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 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 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 Es el 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 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 [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.
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 parámetros específicos del proveedor de billetera electrónica seleccionado.

Los parámetros obligatorios son los siguientes:
  • ewallet_merchant_name: Es el nombre visible del comercio que se muestra a los usuarios.
  • ewallet_merchant_account: Es el identificador de comerciante emitido por la billetera electrónica o el agregador.
  • psp_transaction_reference: Es un número de referencia único que genera el PSP para la idempotencia.