Transacciones iniciadas por el comerciante (MITs)

Descripción general de la asistencia de MIT

Las transacciones iniciadas por el comerciante (MITs) son transacciones que se procesan sin que el usuario esté en una sesión activa. Esta actualización de la API Google Pay Online ofrece una mayor visibilidad de estos tipos de transacciones, una experiencia de usuario mejorada a través de una experiencia de usuario específica para los detalles de facturación y una mayor continuidad de los pagos.

Casos prácticos destacados

  • Pagos periódicos: servicios de streaming digital, suscripciones o utilidades.
  • Pagos aplazados: reservas de hoteles, pedidos anticipados o comisiones por no presentarse.
  • Recargas automáticas: recargas de valor almacenado para tarjetas de transporte público o tarjetas regalo.

Implementación de la API MIT

La API de MIT es una extensión de la API de LoadPaymentData actual. Los integradores deben incluir exactamente un objeto *TransactionInfo para especificar la intención de facturación. Google ofrece tres opciones en función del tipo de transacción iniciada por el comerciante:

Tipo de transacción Nombre de objeto Descripción
Periódico RecurringTransactionInfo Se usa para los cargos de frecuencia fija. Admite pruebas, facturación prepago y pospago.
Diferido DeferredTransactionInfo Se usa para un único cargo en un momento futuro predeterminado.
Recarga automática AutomaticReloadTransactionInfo Se usa para recargar una cuenta de valor almacenado cuando el saldo es inferior a un umbral mínimo.

Pasos de integración

  1. Documentación: las tres nuevas definiciones de objeto se encuentran en la sección Referencia de objeto de la documentación y están vinculadas directamente en la lista anterior.
  2. Implementación: usa los objetos *TransactionInfo relevantes para tu sistema en tu solicitud a la API.
    • Ten en cuenta que solo se puede enviar un objeto por solicitud a la API. El comerciante es quien debe determinar qué objeto usar y rellenar los campos.
  3. Pruebas: usa el entorno de PRUEBAS para validar que los detalles de facturación se renderizan correctamente en la hoja de pago.
  4. Lanzamiento: empieza a emitir en directo una vez que se hayan verificado los parámetros.

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

La gestión del ciclo de vida de los tokens asegura la continuidad de los pagos proporcionando notificaciones en tiempo real cuando se actualizan o desactivan los tokens de pago seguros. Para obtener más información, consulta la documentación sobre la gestión del ciclo de vida de los tokens .

Eventos de token 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 subyacente.

Requisitos de configuración del servidor

Los comerciantes directos y los proveedores de servicios de pago (PSPs) deben establecer un sistema para recibir, descifrar y procesar estos mensajes.

Requisito Descripción
Endpoint Endpoint HTTPS seguro para recibir llamadas POST.
Autenticación Debe gestionar la validación de la firma y el descifrado de los mensajes.
Respuesta Devuelve SUCCESS para continuar con las notificaciones o TOKEN_NOT_FOUND/TOKEN_NOT_IN_USE para detenerlas.
Notificación de comerciante Los PSPs deberán comunicar el estado del token a sus comerciantes.

Notas de implementación

El endpoint tokenUpdateUrl debe incluirse en la transacción para recibir actualizaciones del token. Los proveedores de servicios de pago son los responsables de determinar cómo recibirán y rellenarán los comerciantes esta URL en el objeto *TransactionInfo correspondiente.

Ten en cuenta también que la carga útil cifrada devolverá un campo opcional adicional, merchantTokenId, para las MITs. Para obtener información específica, consulta la documentación sobre Criptografía de datos de pago (para comerciantes) o sobre la estructura de la carga útil (para PSPs).