Saltar al contenido principal

🗓️ Cómo configurar la fecha tope para reintentos de cobro en pagos

❓ ¿Qué es la fecha tope para reintentos?​

La fecha tope para reintentos define hasta cuándo la plataforma Debi intentará realizar un cobro de forma automática. Esto es útil para evitar que los pagos queden en estado de reintento durante el cierre del mes o más allá del período útil de cobro.

⚙️ ¿Cómo se configura?​

Este comportamiento se gestiona mediante el campo can_auto_retry_until, que puede establecerse en el momento de importar pagos.

💼 Formas de configuración:​

  • Importación manual: al subir un archivo con pagos, se puede incluir este campo con la fecha deseada.
  • Salesforce: se establece por defecto al día 25 de cada mes.
  • API: los clientes pueden definirlo según sus necesidades.

⚠️ Importante: este campo solo puede ser asignado en el momento de la importación del pago. No se puede modificar posteriormente.

🧠 Recomendación clave​

Si deseas evitar que haya pagos “en proceso” hacia fin de mes, te recomendamos que configures el campo can_auto_retry_until como máximo el día 25 del mismo mes en el que se cargan los pagos.

Esto se debe a que, aunque Debi detenga los reintentos en esa fecha, la entidad financiera podría seguir procesando respuestas fuera de ese período, lo cual escapa al control de la plataforma.

Consulta los tiempos de procesamiento para entender mejor este punto.

🔧 ¿Qué sucede si no configuro una fecha?​

Cuando no se define una fecha específica, se aplica la configuración por defecto del usuario:

  • auto_retries_max_attempts: máximo de reintentos permitidos (por defecto: 2).
  • auto_retries_within_weeks: semanas en las que se intentará el cobro (por defecto: 3 semanas).

🛎️ Para modificar estos valores base, contacta al equipo de soporte.

🧾 Ejemplo: cómo actúa can_auto_retry_until​

En el siguiente caso real, se configuró el valor can_auto_retry_until = 25/10/2022.

Secuencia del pago:

  1. 17/10/2022: se crea y envía el pago.
  2. 21/10/2022: se recibe una primera respuesta de rechazo. Se realiza el primer reintento.
  3. 27/10/2022: se recibe un segundo rechazo. Como esta fecha excede el can_auto_retry_until, el sistema detiene nuevos intentos.

Resultado final: el pago queda con estado rechazado.

Historial del pago

📌 Conclusión​

Establecer una fecha límite para los reintentos de cobro es una buena práctica que ayuda a mantener ordenado tu flujo de pagos y evitar cobros fuera de plazo. Aprovecha esta funcionalidad especialmente al realizar cargas masivas o al configurar integraciones personalizadas.