Salida a producción

Checklist antes de cambiar tu integración a los endpoints de producción.

Validación de hash IPN funcionando

Probada con al menos un caso E, uno C y uno X en UAT.

Endpoint IPN público

Accesible desde internet, no localhost. Responde HTTP 200 en menos de 5 segundos.

Credenciales productivas generadas

Nuevas credenciales (no las de UAT). Almacenadas en gestor de secretos.

URLs swap completo

Backend apunta a https://apipagosbg.bgeneral.cloud. Frontend usa el CDN bt-cdn.yappy.cloud.

Plan de monitoreo

Logs estructurados en cada llamada IPN, alertas si falla la validación de hash, dashboard de transacciones por estado.

No reutilices credenciales UAT en producción

Genera credenciales nuevas desde la web productiva de Yappy Comercial. UAT y PROD son ambientes completamente separados.

Diferencias UAT vs Producción

Aspecto	UAT (Desarrollo)	Producción
Backend base URL	`https://api-comecom-uat.yappycloud.com`	`https://apipagosbg.bgeneral.cloud`
CDN Web Component	`https://bt-cdn-uat.yappycloud.com/v1/cdn/web-component-btn-yappy.js`	`https://bt-cdn.yappy.cloud/v1/cdn/web-component-btn-yappy.js`
Plataforma web	`https://comwebuat.yappycloud.com/`	`https://comercial.yappy.com.pa/`
Credenciales	Generadas en plataforma UAT	Nuevas, generadas en plataforma productiva
Horario de disponibilidad	Lunes a Viernes, 7:00 AM – 6:30 PM	24/7
App Yappy del cliente	App de pruebas (Descarga solo con invitación)	App productiva (tienda oficial de aplicaciones)

Checklist de migración

Generar credenciales productivas desde la plataforma web productiva (https://comercial.yappy.com.pa/). Anota el merchantId y descarga la CLAVE_SECRETA en formato base64.
Actualizar variables de entorno de tu aplicación: reemplaza YAPPY_MERCHANT_ID y CLAVE_SECRETA con los valores productivos. Nunca hagas commit de estos valores — usa un gestor de secretos.
Cambiar base URL del backend: actualiza la configuración para que apunte a https://apipagosbg.bgeneral.cloud.
Cambiar URL del CDN en el frontend: actualiza el script tag para cargar desde https://bt-cdn.yappy.cloud/v1/cdn/web-component-btn-yappy.js.
Verificar que el endpoint IPN apunte a tu servidor productivo. Si antes usabas un túnel (ngrok, localtunnel), asegúrate de que la ipnUrl sea la URL pública permanente.
Ejecutar smoke test: crea una transacción de $0.01 usando un número Yappy real. Verifica que el IPN llegue correctamente y que el hash se valide sin errores.
Monitorear logs del endpoint IPN por al menos 24 horas después del lanzamiento. Revisa que no haya errores de validación de hash, timeouts, o fallos de conectividad.

Ejemplo: migración de variables de entorno

# Entorno UAT (desarrollo)
YAPPY_BASE_URL=https://api-comecom-uat.yappycloud.com
YAPPY_CDN_URL=https://bt-cdn-uat.yappycloud.com/v1/cdn/web-component-btn-yappy.js
YAPPY_MERCHANT_ID=5c2d13e5-537f-43f1-b1d0-d90d8fdaf8be
YAPPY_CLAVE_SECRETA=dGVzdGluZy1zZWNyZXQtdWF0LWJhc2U2NC1lbmNvZGVkLWhlcmU=

# Entorno PRODUCTIVO
YAPPY_BASE_URL=https://apipagosbg.bgeneral.cloud
YAPPY_CDN_URL=https://bt-cdn.yappy.cloud/v1/cdn/web-component-btn-yappy.js
YAPPY_MERCHANT_ID=a1b2c3d4-e5f6-7890-abcd-ef1234567890   # NUEVO
YAPPY_CLAVE_SECRETA=cHJvZHVjdGlvbi1zZWNyZXQtYmFzZTY0LWVuY29kZWQtaGVyZQ==  # NUEVO

Pro tip: Usa una variable de entorno para controlar el ambiente

En lugar de reemplazar manualmente las URLs, configura una variable YAPPY_ENV=production que cargue el set correcto de URLs y credenciales. Esto facilita rollbacks y pipelines de CI/CD.

¿Te fue útil esta página?