Cómo habilitar PagueloFacil como pasarela de pago en MGPanel

Antes de empezar

A diferencia de Banco General, con PagueloFacil puedes crear tu cuenta de comercio de forma más directa desde su propio sitio. Aun así, tu cuenta pasa por un proceso de validación antes de que te entreguen las credenciales que necesitas activar en MGPanel. Aquí te explicamos qué es la integración, el flujo general para afiliarte, y cómo activarla.

¿Qué es esta integración? (en una frase)

PagueloFacil es una plataforma de pagos de Panamá que acepta tarjeta de crédito/débito, CLAVE (billetera digital panameña) y CASH. En MGPanel funciona mediante un enlace de pago: al momento de pagar, tu cliente es redirigido al sitio seguro de PagueloFacil para completar la transacción — la tarjeta nunca se ingresa en tu sitio, lo que reduce la carga de cumplimiento PCI-DSS que tendrías que asumir si procesaras la tarjeta directamente.

El proceso de afiliación, a grandes rasgos

Crea o inicia sesión en tu cuenta de comercio directamente en app.paguelofacil.com. Este es el flujo general, confirmado también por su documentación técnica (que separa credenciales de prueba y de producción):

1. Crea tu cuenta de comercio en app.paguelofacil.com (puedes empezar por su ambiente de pruebas para conocer el flujo antes de operar en real).
2. Carga los documentos de tu negocio que te soliciten para validar tu comercio.
3. Espera la validación de PagueloFacil sobre tu cuenta.
4. Obtén tus credenciales desde la pestaña Llaves del panel de PagueloFacil: ahí encontrarás el Código Web (CCLW) y el Access token API — primero los de ambiente de pruebas, y luego los de producción una vez que tu cuenta esté activa.

Para el detalle exacto de requisitos y documentos, consulta directamente con PagueloFacil: [email protected], WhatsApp +507 6759-6674, o su portal de desarrolladores en developers.paguelofacil.com.

Cómo activar las credenciales en MGPanel

1. En el panel, entra a Integraciones.
2. En APIs y servicios, busca la tarjeta PagueloFacil y haz clic para abrir su configuración.
3. Completa el CCLW (lo encuentras en PagueloFacil → pestaña Llaves → Código Web) — es el único dato obligatorio.
4. En esa misma pestaña Llaves encontrarás el Access token API; puedes agregarlo como access_token: MGPanel lo usa para verificar cada transacción directamente contra la API de PagueloFacil como capa extra de seguridad, además de la confirmación automática.
5. Si vas a usar confirmación automática por webhook, configura el webhook_token correspondiente.
6. Selecciona el Ambiente: Pruebas mientras validas el flujo, Producción cuando tengas tus credenciales definitivas.
7. Enciende el switch Activa.
8. Pulsa Guardar (o Ctrl + S).

Las credenciales quedan encriptadas al guardarse en MGPanel.

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 «Pagar con PagueloFacil (tarjeta, CLAVE, CASH)» y pulsa «Continuar al pago»: es redirigido al sitio seguro de PagueloFacil (sandbox o producción, según el ambiente que tengas activo), completa el pago ahí, y vuelve a tu sitio. La factura se marca como pagada automáticamente y el pago queda registrado en tu módulo de Pagos.

La confirmación llega principalmente por webhook (PagueloFacil le avisa a MGPanel directamente cuando el pago se aprueba); si por algún motivo el webhook no llega, MGPanel también verifica el pago cuando tu cliente regresa a la factura.

Antes de cerrar: 3 revisiones rápidas

• El CCLW está copiado tal cual te lo entregó PagueloFacil, sin espacios de más.
• Estás en el ambiente correcto (Pruebas mientras validas, Producción solo con credenciales definitivas).
• Si activaste el webhook, hiciste al menos un pago de prueba completo para confirmar que la factura se marca pagada sola.

¿Necesitas ayuda?

Para dudas sobre tu cuenta de PagueloFacil (documentos, validación, credenciales), contacta directamente a PagueloFacil. Para dudas sobre cómo se ve o se activa dentro de MGPanel, escríbenos a [email protected] o pregúntale a emyi desde tu panel.