Errores comunes en pagos
Errores comunes en pagos
A continuación encontrará los problemas más frecuentes relacionados con pagos en Agenda Lite y cómo solucionarlos.
Pago atascado en "pending"
Si una reserva permanece en estado pending sin cambiar a paid, generalmente se debe a que la notificación del proveedor (webhook) no llegó correctamente a su sitio.
- Verifique que su sitio sea accesible desde internet (no localhost).
- Confirme que la URL de webhook esté correctamente registrada en el panel del proveedor.
- Revise los logs de su servidor en busca de errores al recibir el webhook.
Webhook no confirma el pago
Si el proveedor envía la notificación pero Agenda Lite no la procesa:
- Verifique que las credenciales de verificación (webhook secret, API keys) sean correctas.
- Asegúrese de que no haya plugins de seguridad bloqueando las solicitudes entrantes del proveedor.
- Confirme que su certificado SSL sea válido.
Credenciales incorrectas
Un error frecuente es copiar las credenciales con espacios adicionales o mezclar claves de distintos entornos.
Discrepancia sandbox vs producción
Si activó el modo de producción pero ingresó credenciales de prueba, los pagos fallarán con errores de autenticación. Revise en que el modo y las credenciales sean consistentes.
Error de moneda
Algunos proveedores solo aceptan monedas específicas. Si el servicio está configurado con una moneda que el proveedor no soporta, el pago será rechazado.
Límite de webhooks
Agenda Lite aplica un límite de 120 notificaciones por proveedor cada 60 segundos para proteger su sitio contra abusos. Si el proveedor envía más notificaciones de las permitidas, las solicitudes excedentes serán rechazadas temporalmente.
En condiciones normales, este límite no se alcanza. Si lo experimenta, puede ser señal de una configuración duplicada o un problema en el lado del proveedor.
Lista de verificación general
- Confirme que su sitio usa HTTPS con un certificado SSL válido.
- Verifique que las credenciales estén correctas y correspondan al entorno activo.
- Asegúrese de que el modo (sandbox/producción) sea el correcto.
- Compruebe que ningún plugin de seguridad o firewall bloquee los webhooks.
- Revise que la moneda del servicio sea compatible con el proveedor seleccionado.