Antes de empezar: esto no es un botón para encender
A diferencia de otras pasarelas de pago que puedes activar tú mismo desde Integraciones en minutos, Banco General requiere un trámite previo directamente con el banco. No es autoservicio: cada comercio debe solicitarlo, pasar por un proceso de afiliación y recibir sus propias credenciales antes de poder activarlo en MGPanel. Aquí te contamos el proceso completo, de principio a fin.
¿Qué es esta integración? (en una frase)
Banco General de Panamá no opera su propia pasarela: procesa los pagos con tarjeta a través de Cybersource (de Visa), usando su producto Unified Checkout. En la práctica esto significa un widget de pago embebido en tu checkout, donde el comprador ingresa su tarjeta directamente en un formulario seguro del banco —tu servidor nunca maneja el número de tarjeta— y pasa automáticamente por verificación 3D Secure antes de aprobarse.
El proceso completo, paso a paso
- Solicita la afiliación de comercio electrónico. Escribe a Banco General ([email protected]) pidiendo habilitar el servicio de pagos en línea para tu negocio.
- El banco registra tu comercio. Un agente crea tu perfil en Cybersource y te entrega acceso a su portal de administración de pruebas, con un identificador de organización propio de tu comercio.
- Solicitas las llaves de prueba (API keys). Con ese acceso, pides al banco las credenciales REST para el ambiente de pruebas.
- El banco te envía las credenciales de prueba. Recibirás tres datos: Merchant ID (MID), Key ID y Shared Secret, además de un Excel con una matriz de tarjetas de prueba (Visa y Mastercard) para simular distintos escenarios de pago.
- Haces las pruebas y notificas al banco. Activas la integración en MGPanel en ambiente de pruebas (ver siguiente sección), corres las transacciones de la matriz que te envió el banco y le confirmas los resultados.
- El banco revisa y entrega las llaves de producción. Una vez aprobadas las pruebas, te envían un nuevo Merchant ID, Key ID y Shared Secret para el ambiente real. Solo cambias esas credenciales y el ambiente en MGPanel, sin tocar nada más.
Ninguno de estos pasos ocurre dentro de MGPanel — son gestiones directas con Banco General. MGPanel entra en juego en los pasos 5 y 6, cuando ya tienes credenciales que activar.
Cómo activar las credenciales en MGPanel
- En el panel, entra a Integraciones.
- En APIs y servicios, busca la tarjeta Banco General y haz clic para abrir su configuración.
- Completa las tres credenciales que te dio el banco: Merchant ID (MID), Key ID y Shared Secret.
- Selecciona el Ambiente: Pruebas mientras corres la matriz de tarjetas, Producción cuando el banco te entregue las llaves definitivas.
- Enciende el switch Activa.
- Pulsa Guardar (o
Ctrl + S).
Las credenciales quedan encriptadas al guardarse; el campo Shared Secret nunca se vuelve a mostrar en texto plano dentro del panel.
Qué ve tu cliente al pagar
Con la integración activa, cualquier factura que envíes puede pagarse en línea. Tu cliente entra al enlace de la factura, elige la opción «Tarjeta de crédito o débito (Banco General)» y pulsa «Continuar al pago»: ahí se abre el formulario embebido del banco, ingresa su tarjeta, completa la verificación 3D Secure y, si todo sale bien, la factura se marca como pagada automáticamente y el pago queda registrado en tu módulo de Pagos.
Por ahora, la integración solo acepta tarjetas Visa y Mastercard ingresadas directamente en el formulario; billeteras digitales como Google Pay o Apple Pay no están habilitadas en esta primera versión.
Antes de cerrar: 3 revisiones rápidas
- Copiaste el Merchant ID, Key ID y Shared Secret tal cual te los envió el banco, sin espacios de más.
- Estás en el ambiente correcto (Pruebas mientras validas, Producción solo con las llaves definitivas).
- Corriste todos los casos de la matriz de tarjetas de prueba antes de pedirle al banco las credenciales de producción.
¿Necesitas ayuda?
Si te trabas en cualquier paso —del lado del banco o dentro de MGPanel— escríbenos a [email protected] o pregúntale a emyi desde tu panel.
