La afiliación inicial corresponde al equipo de Ventas Yappy. Escríbeles a especialistayappy@bgeneral.com con los datos de tu empresa (RUC, sitio web, volumen estimado de transacciones).

Una vez afiliado, te asignaremos un Customer Success Officer que te acompañará durante toda la integración técnica.

La integración técnica no tiene costo. Las comisiones por transacción se acuerdan durante el proceso comercial con el equipo de Ventas Yappy según el perfil de tu comercio.

No necesariamente. Yappy es multi-banco — funciona con clientes de los 8 bancos del ecosistema Yappy en Panamá. Lo único requerido es que el cliente tenga la app de Yappy activa con su número celular registrado.

Botón de Pago opera con comercios afiliados a Yappy Comercial en Panamá. Los aliasYappy son números de celular panameños de 8 dígitos. Si tu operación está fuera de Panamá, contacta a Ventas Yappy para validar opciones.

Un equipo de desarrollo familiarizado con APIs REST puede tener un hello-world en UAT en 1–2 días. La salida a producción —incluyendo pruebas, validación de hash, y monitoreo— suele tomar entre 1 y 3 semanas dependiendo de la complejidad del sistema del comercio.

Necesitas backend obligatoriamente. Las llamadas a validate/merchant y payment-wc requieren tu merchantId y debe procesarse del lado del servidor para no exponer credenciales. Adicionalmente, el endpoint de IPN debe ser un servicio expuesto a internet con HTTPS.

El Web Component está diseñado para entornos web. En apps móviles nativas hay dos opciones: (1) embebido en un WebView con bridge JavaScript-nativo, o (2) implementar el flujo equivalente llamando directamente a las APIs REST, mostrando instrucciones al usuario para que abra su app de Yappy y confirme el pago.

Los 6 themes oficiales (blue, darkBlue, orange, dark, sky, light) más el atributo rounded son las únicas variantes soportadas. Por temas de consistencia de marca y reconocimiento del cliente, no se permite modificar colores, tipografía o iconografía del botón.

Las causas más comunes son:

1. Tu endpoint está declarado como POST en lugar de GET.
2. Tu endpoint no es accesible desde internet (localhost, detrás de firewall).
3. La ipnUrl que envías al crear la orden no coincide con la URL real expuesta.
4. Tu servidor responde con HTTP 4xx o tarda más de 5 segundos.

Hay reintentos limitados. Por eso es crítico que tu endpoint responda HTTP 200 rápido (incluso si la validación de hash falla, devuelve 200 con { "success": false }) y que proceses la lógica de negocio de manera idempotente — un mismo orderId puede llegar más de una vez.

Errores recurrentes en este orden:

1. Decodificación base64 de la CLAVE_SECRETA.
2. Split por . — usa solo el primer segmento como llave HMAC.
3. Concatenación sin separadores — exactamente orderId + status + domain.
4. Hex en minúsculas — la salida debe estar en lowercase.
5. Encoding del mensaje — UTF-8, no ASCII ni Latin-1.

NO actualices el estado de la orden. Devuelve HTTP 200 con { "success": false }, registra el evento en tu log de seguridad.

Nunca rechaces con códigos 4xx o 5xx — Yappy podría reintentar y saturar tu sistema.

La liquidación de los fondos sigue las reglas operativas estándar de Banco General para Yappy Comercial. Para detalles específicos sobre tu plan de liquidación, consulta con tu Customer Success Officer.

Tienes tres herramientas:

1. El campo confirmationNumber que llega en cada IPN.
2. El historial completo desde la plataforma web de Yappy Comercial.
3. Las APIs de Integración (consulta de historial y puntual) — ideales si manejas alto volumen.

Sí, las APIs de Integración incluyen un endpoint de anulación que permite reversar una transacción antes de la medianoche del mismo día. Después de ese corte, la reversa requiere proceso operativo manual.

Una vez afiliado tu comercio, tu Customer Success Officer te entrega: usuario y contraseña UAT, credenciales de Botón de Pago de pruebas, y los pasos para descargar la app de Yappy de pruebas vía Firebase App Distribution.

No. UAT y producción son entornos completamente separados. Antes de salir vivo, debes generar credenciales productivas nuevas desde la plataforma web productiva.

Cada vez que regeneras credenciales, las anteriores quedan desactivadas automáticamente. Coordina el cambio con tu equipo técnico e implementa la nueva CLAVE_SECRETA inmediatamente para evitar downtime.

El error E004 indica que los valores de los atributos enviados no cumplen el formato correcto. Verifica:

• Que orderId no exceda 32 caracteres alfanuméricos.
• Que aliasYappy sean exactamente 8 dígitos sin guiones ni prefijo.
• Que los montos cumplan formato “0.00” con dos decimales.
• Que no haya smart quotes en el JSON.

Tu primer punto de contacto siempre es tu Customer Success Officer asignado. Para temas generales, escribe a botondepagoyappy@bgeneral.com con: nombre del comercio, descripción del problema, ejemplo de orderId afectado, y logs/screenshots relevantes.

Los compromisos de disponibilidad y soporte se acuerdan durante el proceso comercial. Consulta a tu equipo de Ventas o Customer Success Officer por los detalles aplicables a tu comercio.