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.

  1. Verifique que su sitio sea accesible desde internet (no localhost).
  2. Confirme que la URL de webhook esté correctamente registrada en el panel del proveedor.
  3. 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:

  1. Verifique que las credenciales de verificación (webhook secret, API keys) sean correctas.
  2. Asegúrese de que no haya plugins de seguridad bloqueando las solicitudes entrantes del proveedor.
  3. Confirme que su certificado SSL sea válido.
Importante
Todos los proveedores de pago requieren que su sitio utilice HTTPS. Los webhooks no funcionarán en sitios sin certificado SSL válido.

Credenciales incorrectas

Un error frecuente es copiar las credenciales con espacios adicionales o mezclar claves de distintos entornos.

Error común
Usar credenciales de sandbox con el modo de producción activado (o viceversa). Siempre verifique que las credenciales correspondan al entorno seleccionado.

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 Agenda Lite → Integraciones 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.

Consejo
Verifique en la documentación de su proveedor qué monedas son compatibles antes de configurar sus servicios.

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

  1. Confirme que su sitio usa HTTPS con un certificado SSL válido.
  2. Verifique que las credenciales estén correctas y correspondan al entorno activo.
  3. Asegúrese de que el modo (sandbox/producción) sea el correcto.
  4. Compruebe que ningún plugin de seguridad o firewall bloquee los webhooks.
  5. Revise que la moneda del servicio sea compatible con el proveedor seleccionado.
Información
Si después de seguir estos pasos el problema persiste, contacte al soporte de Agenda Lite proporcionando el nombre del proveedor, el estado del pago y cualquier mensaje de error visible.

En esta página