Transacciones iniciadas por el comerciante (MITs)

Información general sobre la asistencia de MIT

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

Casos prácticos clave

  • Pagos periódicos: servicios de streaming digital, suscripciones o suministros.
  • Pagos aplazados: reservas de hoteles, pedidos anticipados o tarifas 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 MIT es una extensión de la API 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: accede al sitio para desarrolladores durante el programa de acceso anticipado. Las tres nuevas definiciones de objeto se encuentran en la sección Referencia de objeto 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 decidir qué objeto usar y rellenar los campos.
  3. Pruebas: usa el entorno de PRUEBA para validar que los detalles de facturación se muestran 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 todos los detalles, consulta la documentación sobre 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 número de cuenta principal: 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 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 seguir recibiendo 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 sobre la implementación

El endpoint tokenUpdateUrl debe incluirse en la transacción para recibir actualizaciones del token. En el caso de los PSPs, es responsabilidad de estos 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).