Transacciones iniciadas por el comercio (MIT)

Descripción general de la asistencia de MIT

Las transacciones iniciadas por el comercio (MIT) son transacciones que se procesan sin que el usuario esté activo en la sesión. Esta actualización de la API de Google Pay Online proporciona mayor visibilidad para estos tipos de transacciones, una mejor experiencia del usuario 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 por adelantado o cargos por no presentarse
  • Recargas automáticas: Recargas de valor almacenado para tarjetas de regalo o de transporte público

Implementación de la API de MIT

La API de MIT es una extensión de la API de loadPaymentData existente. 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 los cargos de frecuencia fija. Admite facturación de prueba, prepagada y pospagada.
Diferido 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 el saldo cae por debajo de un umbral mínimo.

Pasos de integración

  1. Documentación: Las tres nuevas definiciones de objetos se encuentran en la sección Referencia de objetos de la documentación y están vinculadas directamente en la lista anterior.
  2. Implementación: Usa los objetos *TransactionInfo pertinentes para tu sistema en la solicitud a 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 todos los detalles, consulta la documentación sobre la administración del ciclo de vida del token

Eventos de tokens clave

  • Desactivación o eliminación: Notifica cuando un token ya no se puede usar.
  • Actualizaciones del sufijo del FPAN: Se producen 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 Es un extremo HTTPS seguro para recibir llamadas POST.
Autenticación Debe controlar la validación de firmas y la desencriptación de mensajes.
Respuesta Devuelve SUCCESS para continuar con las notificaciones o TOKEN_NOT_FOUND/TOKEN_NOT_IN_USE para detenerlas.
Notificación del comercio Los PSPs deberán comunicar el estado del token a sus comercios.

Notas de implementación

El extremo tokenUpdateUrl se debe pasar 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 devolverá un campo opcional adicional, merchantTokenId, para los MIT. Para obtener detalles específicos, consulta la documentación de Criptografía de datos de pago (para comercios) o Estructura de carga útil (para PSP).