Cómo integrar Sagicor eCommerce (MPGS) en Jamaica

Para integrar Sagicor eCommerce en Jamaica, primero obtenga la aprobación de una cuenta comercial para pasarela de pagos con Sagicor Bank. Confirme si su cuenta admite MPGS Direct o MPGS Hosted Checkout, cree las credenciales API requeridas desde el portal de comerciantes de Mastercard, configure la opción correspondiente de Sagicor MPGS en Genius Checkout, realice pruebas de todo el ciclo de pago y, entonces, repita la configuración con las credenciales de producción.

Cada configuración debe coincidir exactamente con la cuenta que Sagicor aprobó para su empresa. Tener acceso al portal no significa necesariamente que estén activados el acceso API Direct, Hosted Checkout, tokenización, pagos recurrentes, reembolsos o todas las monedas.

Última revisión: 25 de septiembre de 2026.

#Qué hace cada empresa

Sagicor describe su Payment Gateway Solution como una herramienta para que negocios procesen pagos online. La aprobación, tarifas, tiempos de liquidación, aceptación de tarjetas y requisitos de riesgo siguen sujetos al acuerdo vigente con el banco.

#1. Solicite la cuenta de comercio adecuada con Sagicor

Explique al banco cómo recibirá pagos su empresa antes de solicitar credenciales técnicas. Un hotel que recibe depósitos, una tienda en línea que despacha productos o un negocio de membresías con cobros recurrentes pueden requerir capacidades distintas.

Solicite a Sagicor la confirmación por escrito de estos puntos:

• Nombre legal del negocio e ID de comerciante.
• Si la cuenta opera con MPGS Direct, Hosted Checkout, o ambos.
• URLs de administración en modo de prueba y de producción.
• Monedas y marcas de tarjeta habilitadas.
• Si 3-D Secure es requerido y está activo.
• Si se permite PURCHASE para capturar fondos de inmediato.
• Si se permite AUTHORIZE y posterior CAPTURE.
• Si están habilitados los anulaciones, reembolsos totales y parciales.
• Si se permite tokenización y pagos recurrentes iniciados por el comerciante.
• Cuenta bancaria de liquidación y monedas de liquidación.

No elija Direct ni Hosted Checkout solo por una imagen de pantalla o por la configuración de otro comercio. Utilice el paquete de bienvenida emitido para su propio ID de comerciante.

#2. Elija entre MPGS Direct o Hosted Checkout

Ambos modos facilitan el cobro online con tarjeta, pero la experiencia del pago y los requisitos de cuenta varían.

Si su negocio ofrecerá suscripciones o comenzará con prueba gratuita y cobro posterior, asegure la habilitación de tokenización antes de construir el sitio. Una transacción exitosa no garantiza por sí sola que se pueda almacenar un método de pago reutilizable.

#3. Cree la contraseña API de MPGS

El portal administrativo de MPGS de Sagicor suele estar en sagicorbank.gateway.mastercard.com/ma. Use el enlace que reciba en el correo de bienvenida, si es diferente.

La contraseña de acceso al portal y la contraseña API son credenciales distintas. Para prepararse para la autenticación vía API:

1. Inicie sesión con el usuario administrador asignado por el banco.
2. Vaya a Admin → Operators y cree un operador si el perfil aún no tiene uno para integraciones.
3. Inicie sesión como el operador correspondiente.
4. Acceda a Admin → Integration Settings → Edit.
5. Genere y habilite Password 1, exclusiva para acceso por API.
6. Guarde la contraseña en un administrador de contraseñas. No la envíe por correo, ni la capture en capturas de pantalla, ni la suba a control de versiones.

Genius Checkout arma el nombre de usuario API de MPGS como merchant.<Merchant ID>. En la configuración, ingrese solo el Merchant ID. No añada el prefijo merchant. a menos que se lo indique explícitamente el campo.

#4. Configure Sagicor MPGS en Genius Checkout

Comience en modo de prueba para evitar impactar pedidos reales por errores de configuración.

1. Inicie sesión en la cuenta de Genius Checkout que procesará los pagos.
2. Ingrese al menú Gateways.
3. Seleccione MPGS Direct o MPGS Hosted Checkout de acuerdo con la cuenta aprobada.
4. Elija la plantilla regional de Sagicor cuando esté disponible.
5. Use https://sagicorbank.gateway.mastercard.com como URL base de la pasarela salvo que Sagicor le indique otra.
6. Ingrese el Merchant ID y la contraseña API actual.
7. Mantenga la versión API recomendada salvo requerimiento expreso del equipo de onboarding.
8. Active solo monedas confirmadas con su cuenta de comerciante.
9. Seleccione Authorize & Capture para cobro inmediato o Authorize Only solo si tiene la aprobación y procesos necesarios para capturar después.
10. Guarde la configuración y utilice Test connection.

La prueba de conexión autentica y crea una sesión vacía en MPGS. No realiza ningún cobro. Por tanto, verificar la conexión prueba que los datos y el host funcionan, pero no garantiza que un pago, desafío de 3-D Secure, captura o reembolso funcionen.

Consulte la guía completa de configuración MPGS mientras ingresa los parámetros.

#5. Conecte el software que ya utiliza el negocio

Una vez que la cuenta MPGS funcione en Genius Checkout, podrá cobrar usando el canal más adecuado:

• Genere enlaces de pago y códigos QR para facturación, ventas por WhatsApp, depósitos o pagos en mostrador.
• Conecte WooCommerce si tiene tienda en WordPress.
• Conecte HighLevel para embudos, agencias, membresías y ventas gestionadas desde CRM.
• Conecte Ecwid o GiveWP si esas plataformas se ajustan a su negocio.
• Use la API de Genius Checkout para web o aplicaciones personalizadas soportadas.

En WordPress, siga la guía específica para MPGS y WooCommerce. Esa guía cubre configuración del plugin, autorización de dominio, notas de pedido, renovaciones, cancelaciones y reembolsos, sin repetir pasos bancarios aquí.

#6. Pruebe más de un pago exitoso

La prueba de lanzamiento debe cubrir los escenarios que la empresa deberá gestionar cuando el sitio esté activo.

Registre el ID de pedido de prueba, ID de transacción en Genius Checkout, referencia MPGS, hora UTC, modo y resultado. Nunca recoja el número completo de tarjeta ni el código de seguridad.

#7. Pase de prueba a producción sin mezclar credenciales

Prueba y producción son configuraciones separadas. Para pagos en vivo:

1. Confirme con Sagicor que el Merchant ID de producción está activo y con las características necesarias.
2. Ingrese Merchant ID y contraseña API de producción en Genius Checkout en el modo de producción.
3. Seleccione solo monedas aprobadas en producción.
4. Autorice el dominio web definitivo si la integración lo requiere.
5. Haga un pago real de bajo monto con una tarjeta aprobada.
6. Verifique pedido, transacción en Genius Checkout, transacción MPGS, recibo, correo y registro bancario de liquidación.
7. Pruebe un reembolso o anulación mientras el equipo de lanzamiento sigue disponible.

Nunca copie una contraseña de prueba en producción ni suponga que las funciones de prueba se mantienen automáticamente en producción.

#Problemas comunes de configuración con Sagicor MPGS

#Falla de autenticación

Confirme que Merchant ID, contraseña API, URL base y entorno correspondan entre sí. Cambiar la contraseña del portal no genera una nueva contraseña API.

#Hosted Checkout no abre

Verifique si Hosted Checkout está activado en el perfil del comerciante. Además, confirme que la página del proveedor se abre como página principal del navegador y no dentro de un iframe que la pasarela bloquee.

#El pago funciona, pero las suscripciones fallan

La cuenta puede autorizar compras sin soportar tokenización ni transacciones iniciadas por el comerciante. Valide la capacidad de tokenización tanto con el banco como con Genius Checkout.

#Una moneda es rechazada

La moneda en el sitio, la moneda configurada en la pasarela Genius Checkout y la habilitada por Sagicor deben coincidir. Ver una moneda en el menú de software no confirma que esté activa en la cuenta de comercio.

#El comprador regresa, pero el pedido no se actualiza

Verifique el callback del gateway, la URL de retorno, la entrega de webhooks y el estado final en MPGS. No marque un pedido como pagado solo por el redireccionamiento del navegador.

#Preguntas frecuentes

#¿Sagicor eCommerce es lo mismo que MPGS?

Sagicor proporciona la relación de comercio y la solución de pasarela de pago al negocio aprobado. MPGS es la tecnología de gateway de Mastercard utilizada. El comercio debe seguir los términos de onboarding de Sagicor y usar las credenciales emitidas para su perfil con Sagicor.

#¿Necesito una cuenta bancaria empresarial en Sagicor?

Los requisitos de cuenta y liquidación los define Sagicor. Pregunte qué cuenta comercial, documentación de debida diligencia y acuerdo de comerciante aplican en su caso.

#¿Puedo usar MPGS sin WooCommerce?

Sí. Genius Checkout permite exponer la configuración aprobada de MPGS mediante enlaces de pago, códigos QR, integraciones de software soportadas y desarrollos a medida mediante la API. La vía correcta depende del flujo de negocio, no solo de la pasarela.

#¿Genius Checkout puede aprobar mi aplicación de comercio?

No. Sagicor controla la aprobación de comercios, liquidaciones, tarifas y capacidades de gateway. Genius Checkout gestiona la conexión de software después de la aprobación del banco.

#Fuentes oficiales y próximos pasos

• Sagicor Payment Gateway Solutions
• Sagicor formas de pago para negocios
• Documentación API Hosted Checkout de Mastercard
• Descripción general de MPGS en Genius Checkout
• Guía de configuración MPGS en Genius Checkout

Cree su cuenta Genius Checkout o agende una revisión de configuración con los detalles de onboarding de Sagicor a mano.