🧾 Tipos de rechazo y categorización estándar
Cuando un pago es rechazado, las entidades financieras devuelven un motivo en el campo response_message dentro del objeto pago.
Estos mensajes suelen ser genéricos o variables entre entidades, dificultando el análisis.
Para facilitar esto, desde Debi clasificamos los mensajes en un sistema propio y estandarizado de códigos de rechazo, visible en el campo rejection_code.
📋 Lista de códigos de rechazo estandarizados
| rejection_code | Motivo del rechazo | Próximos pasos |
|---|---|---|
| try_again_later | La entidad financiera indica que no está disponible o no puede procesar en este momento. | Puede intentarse más tarde. |
| processing_error | Error de procesamiento en la entidad financiera. | Puede intentarse más tarde. |
| insufficient_funds | Fondos o Límite insuficiente. | El cliente debe cambiar su medio de pago o debe gestionar un aumento de fondos o límite. |
| stop_payment_order | El medio de pago tiene una orden de no pagar permanente o temporal o no se puede realizar este tipo de compras. | El cliente puede comunicarse con la entidad emisora para más información. |
| do_not_honor | El banco emisor no está dispuesto a aprobar. | El cliente puede comunicarse con la entidad emisora para más información. |
| transaction_not_allowed | El medio de pago no está habilitada. Es posible que el número esté dado de baja, no soportado, o con un problema. | El cliente puede comunicarse con la entidad emisora para más información. |
| expired_card | La tarjeta está expirada o inhabilitada para su uso. | El cliente debe cambiar su medio de pago. |
| pickup_card | El cliente no puede usar esta tarjeta. Probablemente fue reportada como robada o perdida. | El cliente debe cambiar su medio de pago. |
| stolen_card | Tarjeta reportada como robada. | El cliente debe cambiar su medio de pago. |
| restricted_card | El cliente no puede usar esta tarjeta. Probablemente fue reportada como robada o perdida. | El cliente necesitar usar otra tarjeta. |
| generic_decline | El pago fue rechazado por un motivo desconocido. | El cliente puede comunicarse con la entidad emisora para más información. |
| not-permitted | El medio de pago no está habilitado. Es posible que el número este bloqueado o no este autorizado para el débito automático. | El cliente puede comunicarse con la entidad emisora para más información. |
🔍 Esta clasificación está en mejora continua y se basa en el texto literal de las entidades + estadísticas de procesamiento real.
💡 ¿Por qué es importante la categorización?
La categorización de rechazos es clave para:
- Entender qué rechazos pueden resolverse y cuáles no.
- Evitar intentos repetidos innecesarios.
- Sugerir alternativas más efectivas (otro medio de pago, contacto con banco, etc.).
- Recuperar la experiencia del cliente y su fidelidad al ofrecer soluciones claras.
🌟 Oportunidad y acción
Al identificar rápidamente los rechazos irrecuperables, podés:
- Implementar flujos de comunicación automáticos para cambiar el método de pago.
- Aplicar reglas para evitar reintentos inútiles que generen fricción.
- Priorizar acciones de recuperación donde haya mayor probabilidad de éxito.
❌ Análisis de Rechazos en Pagos – Rejection Insights
La funcionalidad Análisis de Rechazos permite obtener información detallada sobre por qué un intento de cobro fue rechazado, ayudándote a tomar decisiones más informadas y mejorar la tasa de éxito en tus cobros futuros.
🔍 ¿Qué ofrece esta funcionalidad?
📊 Detalle del rechazo individual:
En cada intento de cobro rechazado, verás una sección específica con:
- Código del proveedor (ej. 026)
- Motivo técnico (ej.
transaction-not-allowed) - Texto explicativo sobre el motivo de rechazo
- Estadísticas de rechazos similares (porcentaje de recuperación con reintento, cambio de medio, etc.)
🛠️ ¿Dónde lo encuentro?
- Desde el detalle de un cobro:
- Accede a cualquier intento de cobro rechazado.
- Despalaza hacia abajo.
- Allí verás el bloque a la derecha llamado Rechazo con toda la información analítica.
🧾 Resumen general de motivos de rechazo:
- Visión agregada de los motivos más frecuentes
- Clasificación por cantidad de pagos o montos rechazados
- Porcentaje de incidencia por código (ej. 13.4% corresponde a
transaction-not-allowed)
🛠️ ¿Dónde lo encuentro?
- Desde el panel de resumen:
- Sección Motivos de rechazo.
- Podrás filtrar por cantidad de pagos o por montos totales.
📈 ¿Qué información estadística se muestra?
Para cada rechazo individual, se muestra:
| Métrica | Significado |
|---|---|
| Tasa de recuperación con mismo medio | Porcentaje de intentos exitosos reintentando igual tarjeta |
| Tasa de recuperación rotando medio | Éxito al intentar con una nueva tarjeta |
| Promedio de intentos similares | Cuántos intentos similares se procesan antes de lograr éxito |
💡 Esta información se actualiza constantemente según el comportamiento de la red de pagos.
📌 Conclusión
La funcionalidad de Análisis de Rechazos, junto con el sistema de categorización estandarizada, transforma un rechazo en una oportunidad de mejora. Usá estos datos para segmentar mejor, automatizar decisiones, y recuperar más pagos sin perder clientes en el intento.
Para ver más información sobre cómo sincronizar los motivos de rechazo en tu sistema de gestión, visita el artículo Sincronizar eventos de cambios de estado del pago.