En esta página
- Identifica la cuenta MPGS antes de configurarla
- Direct y Hosted Checkout son integraciones diferentes
- Cómo viaja el pago desde HighLevel
- Configura MPGS en Genius Checkout
- Conecta la ubicación de HighLevel
- Prueba el camino de retorno completo
- Diagnostica “No se pudo iniciar el pago” o HTTP 502
- Pagos recurrentes requieren aprobación de tokenización
- Usa la misma conexión MPGS más allá de HighLevel
- Preguntas frecuentes de los comercios
- Fuentes
Genius Checkout conecta una cuenta compatible de Mastercard Payment Gateway Services con HighLevel como proveedor de pagos personalizado. El comercio mantiene su banco y la relación con MPGS. Genius Checkout crea la sesión de pago, gestiona la transferencia de datos del pago y devuelve el resultado a HighLevel.
Esta guía refleja la implementación de Genius Checkout revisada el 4 de septiembre de 2026. Confirma las URLs del gateway, monedas, tokenización y permisos de transacción con el banco o proveedor de pagos que emitió la cuenta MPGS.
| Detalle de la conexión | Soporte actual de Genius Checkout |
|---|---|
| Nombres de plataforma | HighLevel, GoHighLevel, GHL, LeadConnector |
| Nombres del gateway | Mastercard Payment Gateway Services, MPGS, Mastercard Gateway |
| Modos del gateway | MPGS Direct y MPGS Hosted Checkout |
| Pagos únicos | Soportados |
| Cobros recurrentes | Soportados cuando la cuenta y el método proporcionan un token reutilizable |
| Liquidación | Se gestiona según el acuerdo de adquirencia o banco del comercio |
El comercio controla la imagen de Genius Checkout y los métodos de pago habilitados. El proveedor determina qué operaciones puede realizar la cuenta en el gateway.
Identifica la cuenta MPGS antes de configurarla
Los bancos y proveedores de pagos entregan cuentas MPGS con un identificador de comercio (Merchant ID), un host regional del gateway y datos de autenticación. Un portal bancario con marca propia puede usar tecnología MPGS, pero el nombre del portal por sí solo no garantiza el modo correcto en Genius Checkout.
Revisa el paquete de bienvenida y el portal del gateway para obtener:
- Merchant ID.
- URL base del gateway o región.
- Contraseña API o credenciales de operador para Direct.
- Permisos y configuraciones de Hosted Checkout para HPP.
- Separación entre ambiente de pruebas y producción.
- Monedas habilitadas.
- Permisos para tokenización y pagos recurrentes.
Utiliza “tu banco, por ejemplo Sagicor” al explicar quién proporciona el acceso a MPGS. No afirmes que un banco utiliza MPGS para todos los comercios o países salvo que el banco confirme esa relación para la cuenta.
Direct y Hosted Checkout son integraciones diferentes
Ambos modos pueden operar en la misma cuenta de comercio, pero utilizan solicitudes y flujos de comprador diferentes.
| Decisión | MPGS Direct | MPGS Hosted Checkout |
|---|---|---|
| Interfaz de pago | Genius Checkout coordina el flujo Direct | MPGS presenta el checkout alojado |
| Autenticación | Credenciales API emitidas o creadas para el comercio | Configuración de Hosted Checkout y acceso a la API de sesiones |
| Marca | Controlada en Genius Checkout dentro de los límites del gateway | Logo y apariencia según la configuración de MPGS del comercio |
| Comportamiento en navegador | Depende de la autenticación de tarjeta y el flujo de checkout | Se abre como página alojada por el proveedor y puede requerir navegación a nivel superior |
| Alcance de cumplimiento | Confirmar según la implementación completa | Confirmar según la implementación completa |
El conjunto de credenciales del comercio define qué modo puede activarse. Una contraseña API no reemplaza la provisión de Hosted Checkout, y la configuración de una página alojada no da acceso a Direct.
Cómo viaja el pago desde HighLevel
HighLevel envía los campos compatibles de pedido y comprador a Genius Checkout. Genius Checkout crea una sesión de pago única y selecciona la ruta de MPGS configurada según la moneda de la transacción.
Para Hosted Checkout, el comprador es redirigido a la página de MPGS. Las páginas del proveedor pueden rechazar ser cargadas dentro de un iframe de otra empresa, así que Genius Checkout puede usar una transferencia segura a nivel superior y luego devolver el resultado a HighLevel.
En el caso de Direct, Genius Checkout coordina el pago y la autenticación de tarjeta necesaria según el flujo configurado. La plataforma registra la respuesta del proveedor, crea su propio historial de transacciones y reporta el resultado a HighLevel.
Configura MPGS en Genius Checkout
- Abre Gateways en el comercio correcto dentro de Genius Checkout.
- Selecciona MPGS Direct o MPGS Hosted Checkout.
- Elige modo de pruebas o producción.
- Ingresa el Merchant ID, credenciales de autenticación y la URL del gateway requeridos para ese modo.
- Selecciona únicamente las monedas habilitadas por tu banco o proveedor de pagos.
- Añade el logo para el checkout alojado desde la biblioteca de medios si usas HPP. Una imagen cuadrada de 1000 x 1000 píxeles permite un mejor redimensionado.
- Guarda y resuelve cualquier mensaje de validación visible.
Utiliza los valores emitidos para el modo y ambiente de MPGS seleccionado. Una URL de pruebas con credenciales de producción fallará.
Conecta la ubicación de HighLevel
- Abre la ubicación de HighLevel que gestiona los productos y pagos.
- Instala o abre Genius Checkout en el HighLevel App Marketplace como proveedor de pagos personalizado.
- Autoriza el comercio de Genius Checkout deseado.
- Confirma el nombre del comercio mostrado en la conexión.
- Agrega Genius Checkout a un producto de prueba controlado.
- Ejecuta pruebas de pago único y recurrente por separado.
Datos como nombre, correo, teléfono, dirección, referencia de pedido y otros campos admitidos pueden transferirse a Genius Checkout si HighLevel los proporciona. La integración no debe inventar datos de cliente que falten.
Prueba el camino de retorno completo
Registra el pedido en HighLevel, transacción en Genius Checkout, recibo, referencia de MPGS, marca de tiempo UTC, modo, ambiente y resultado para cada prueba.
Ejecuta estos escenarios:
- Pago exitoso.
- Pago rechazado.
- Cancelación por parte del comprador desde la página de MPGS.
- Acción "Atrás" en el navegador durante Hosted Checkout.
- Retorno exitoso a la confirmación en HighLevel.
- Pago con tarjeta guardada si la tokenización está habilitada.
- Configuración de suscripción y renovación iniciada por el comercio si los pagos recurrentes están activos.
- Reembolso o anulación desde el sistema utilizado por tu equipo de operaciones.
Los controles de Atrás y Cancelar en Hosted Checkout deben permitir que el comprador salga. Si el retorno lleva al comprador nuevamente a MPGS en un bucle, corrige esto antes de lanzar.
Diagnostica “No se pudo iniciar el pago” o HTTP 502
Un HTTP 502 en la ruta de inicio de MPGS indica un fallo de integración o conexión, no un rechazo financiero. Revisa el registro de la API de Genius Checkout y el ID de correlación, luego verifica lo siguiente:
- El comercio tiene una configuración MPGS activa en el modo seleccionado.
- La URL del gateway corresponde al mismo ambiente que las credenciales.
- La moneda está habilitada tanto en Genius Checkout como en MPGS.
- El Merchant ID no contiene espacios ocultos.
- Existen los permisos requeridos de Hosted Checkout.
- El gateway respondió dentro del tiempo permitido.
Genius Checkout debe crear un registro de operación incluso si MPGS falla antes de realizar una transacción financiera. Este registro es clave para soporte, ya que ayuda a diferenciar errores del proveedor y de la plataforma.
Pagos recurrentes requieren aprobación de tokenización
Un pago único exitoso no garantiza que los pagos recurrentes funcionen. La cuenta debe admitir tokens reutilizables y el comportamiento correspondiente para transacciones iniciadas por el comercio. Genius Checkout también aplica las capacidades del plan.
Un reintento de renovación crea un nuevo intento de pago y transacción. La transacción fallida previa no se modifica, manteniendo en ambos sistemas una auditoría precisa.
Usa la misma conexión MPGS más allá de HighLevel
El comercio configura MPGS una vez en Genius Checkout. El modo y capacidades habilitados en la cuenta determinan qué conexiones puede soportar:
- Tiendas WooCommerce.
- Vitrinas Ecwid.
- Formularios de donación GiveWP.
- Enlaces de pago alojados y pagos con código QR.
- Aplicaciones personalizadas compatibles mediante la documentación API de Genius Checkout.
Prueba cada integración. Las URLs de retorno, la sincronización de estados, el manejo de pagos guardados y los puntos de acceso para reembolsos varían por plataforma.
Preguntas frecuentes de los comercios
¿Sagicor eCommerce funciona con HighLevel?
Un comercio puede usar una cuenta MPGS compatible proporcionada por su banco, por ejemplo Sagicor, con esta integración para HighLevel. Configura el host exacto del gateway, modo, credenciales, monedas y permisos emitidos para tu cuenta. Lee el resumen de Sagicor eCommerce.
¿Es posible que MPGS Hosted Checkout permanezca dentro del iframe de HighLevel?
Los encabezados de seguridad del proveedor pueden bloquear la visualización embebida. Genius Checkout utiliza una transferencia segura a nivel superior cuando es necesario y retorna el resultado del pago a HighLevel.
¿Genius Checkout liquida los fondos?
No. El banco o proveedor de pago del comercio gestiona el procesamiento y la liquidación de los fondos según su acuerdo.
¿Dónde puedo revisar todos los campos de MPGS?
Consulta el resumen de MPGS gateway y la guía de campos de MPGS para Genius Checkout.
Fuentes
- Documentación API de Mastercard Gateway
- Documentación de pagos personalizados en HighLevel
- Genius Checkout en el HighLevel App Marketplace
- Resumen de MPGS en Genius Checkout
- Resumen de Genius Checkout para HighLevel
¿Necesitas ayuda para identificar el modo correcto sin compartir credenciales secretas? Agenda una revisión de conexión.