Cómo generar tus credenciales de Yappy y activarlo en MGPanel

Antes de empezar

Yappy es el método de pago móvil de Banco General, uno de los más usados en Panamá. En MGPanel se integra mediante el Botón de Pago Yappy: el cliente confirma el pago desde su propia app de Yappy y la confirmación llega a MGPanel por IPN con firma verificada. Para activarlo necesitas generar tres credenciales en Yappy Comercial y pegarlas en tu panel.

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

Es un botón de pago que tu cliente confirma desde la app de Yappy en su teléfono — no ingresa tarjeta ni sale de tu sitio a un formulario externo, y MGPanel marca la factura como pagada automáticamente al recibir la confirmación.

Genera tus credenciales en Yappy Comercial

Yappy actualiza de vez en cuando la interfaz de su Banca en Línea Comercial, así que el camino exacto (menús, botones) puede variar ligeramente respecto a lo que describimos aquí. Para la guía oficial y siempre actualizada, consulta directamente: Botón de Pago Yappy — nueva integración.

1. Ingresa a tu Banca en Línea Comercial de Banco General con la cuenta de tu negocio.
2. Ve a Administración → Botón de Pago Yappy.
3. Genera la Clave Secreta desde esa sección. Yappy te mostrará el ID del Comercio (Merchant ID) y la Clave Secreta — cópialos de inmediato, ya que por seguridad la clave solo se muestra una vez.
4. Al configurar el botón, Yappy te pedirá también el dominio de tu sitio web (con esquema, ej. https://tusitio.com). Debe coincidir exactamente con tu dominio real y tener SSL activo — lo necesitarás también en el siguiente paso, dentro de MGPanel.

Cómo activar las credenciales en MGPanel

1. En el panel, entra a Integraciones.
2. En APIs y servicios, busca la tarjeta Yappy y haz clic para abrir su configuración.
3. Completa el Merchant ID, la Clave Secreta y el Dominio registrado — los tres son obligatorios y deben coincidir exactamente con lo que configuraste en Yappy Comercial.
4. Enciende el switch Activa.
5. Pulsa Guardar (o Ctrl + S).

La Clave Secreta queda encriptada al guardarse en MGPanel.

Qué ve tu cliente al pagar

Con la integración activa, cualquier factura que envíes puede pagarse con Yappy. Tu cliente entra al enlace de la factura, elige «Pagar con Yappy» y confirma el pago desde la app de Yappy en su teléfono. La confirmación llega a MGPanel por IPN con firma HMAC verificada, la factura se marca como pagada automáticamente y el pago queda registrado en tu módulo de Pagos.

Antes de cerrar: 3 revisiones rápidas

• El Merchant ID y la Clave Secreta están copiados tal cual te los entregó Yappy, sin espacios de más.
• El Dominio registrado coincide exactamente con tu sitio real (mismo esquema https://) y tiene SSL activo.
• Hiciste al menos un pago de prueba completo antes de anunciarlo a tus clientes.

¿Necesitas ayuda?

Para dudas sobre tu cuenta de Yappy Comercial (generación de credenciales, dominio, validación), contacta directamente a Yappy/Banco General. 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.