Transacciones iniciadas por el comercio (MIT)

Descripción general de la compatibilidad con MIT

Las transacciones iniciadas por el comercio (MIT) son transacciones que se procesan sin que el usuario esté activamente en la sesión. Esta actualización de la API de Google Pay Online proporciona una visibilidad mejorada para estos tipos de transacciones, una experiencia del usuario mejorada a través de una UX de detalles de facturación dedicada y una mejor continuidad de los pagos.

Casos prácticos clave

  • Pagos recurrentes: Servicios de transmisión digital, membresías o servicios públicos
  • Pagos diferidos: Reservas de hoteles, pedidos anticipados o tarifas por no presentarse
  • Recargas automáticas: Recargas de valor almacenado para tarjetas de transporte o de regalo

Implementación de la API de MIT

La API de MIT es una extensión de la API existente loadPaymentData . Los integradores deben incluir exactamente un objeto *TransactionInfo para especificar la intención de facturación. Google proporciona 3 opciones según el tipo de transacción iniciada por el comercio:

Tipo de transacción Nombre del objeto Descripción
Recurrente RecurringTransactionInfo Se usa para cargos de frecuencia fija. Admite facturación de prueba, prepaga y pospaga.
Diferida DeferredTransactionInfo Se usa para un solo cargo en un momento futuro predeterminado.
Recarga automática AutomaticReloadTransactionInfo Se usa para recargar una cuenta de valor almacenado cuando un saldo cae por debajo de un umbral mínimo.

Pasos de integración

  1. Documentación: Accede al DevSite durante el Programa de acceso anticipado. Las tres nuevas definiciones de objetos se encuentran en la sección Referencia de objetos, y están vinculadas directamente en la lista anterior.
  2. Implementación: Usa los objetos *TransactionInfo pertinentes para tu sistema en la solicitud de la API.
    • Ten en cuenta que solo se puede pasar un objeto por solicitud a la API. Determinar qué objeto usar y completar los campos depende de cada comercio.
  3. Pruebas: Usa el entorno de PRUEBA para validar que los detalles de facturación se rendericen correctamente en la hoja de pago.
  4. Lanzamiento: Transmite en vivo una vez que se verifiquen los parámetros.

Administración del ciclo de vida de los tokens (TLM)

La administración del ciclo de vida de los tokens garantiza la continuidad de los pagos, ya que proporciona notificaciones en tiempo real cuando se actualizan o desactivan los tokens de pago seguros. Para obtener más detalles, consulta la documentación sobre la administración del ciclo de vida de los tokens .

Eventos clave de tokens

  • Desactivación o eliminación: Notifica cuando un token ya no se puede usar.
  • Actualizaciones del sufijo FPAN: Se produce cuando se actualiza el número de cuenta principal de financiación subyacente.

Requisitos de configuración del servidor

Los comercios directos y los proveedores de servicios de pago (PSP) deben establecer un sistema para recibir, desencriptar y procesar estos mensajes.

Requisito Descripción
Extremo Extremo HTTPS seguro para recibir llamadas POST
Autenticación Debe controlar la validación de firmas y el desencriptado de mensajes.
Respuesta Muestra SUCCESS para continuar con las notificaciones o TOKEN_NOT_FOUND/TOKEN_NOT_IN_USE para detenerlas.
Notificación del comercio Los PSP deberán comunicar el estado del token a sus comercios.

Notas de la implementación

Se debe pasar el extremo tokenUpdateUrl con la transacción para recibir actualizaciones del token. En el caso de los PSP, determinar cómo los comercios recibirán y completarán esta URL en el objeto *TransactionInfo pertinente es responsabilidad del PSP.

También ten en cuenta que la carga útil encriptada mostrará un campo opcional adicional, merchantTokenId, para las MIT. Para obtener detalles específicos, consulta la documentación sobre la criptografía de datos de pago (para comercios) o la documentación sobre la estructura de la carga útil (para PSP).