Recaudo Docs
Crear cuenta

Pagos y clientes

Cobranza

Riesgo y bloques de mora

Clasifica la cartera vencida: cada cliente con saldo vencido recibe un puntaje de riesgo de 0 a 100 (más alto = más difícil de recuperar) y cae en un bloque de mora según su comportamiento. Cada bloque trae su playbook precargado: objetivo, tono, pasos por día y canal, oferta, qué evitar, cómo medirlo y un mensaje base.

GET /api/v1/collections/risk-segments
Campo Tipo Descripción
segmentstringOpcional. Un bloque: legal_hold, promise_active, broken_promise, disputing, unreachable, chronic_late, early_reliable, engaged_no_pay, over_one_year, deep_arrears o developing. Con él la respuesta incluye customers.
limitintegerClientes del bloque (default 20, máximo 50).
sortstringdebt (mayor deuda primero, default) o score (mayor riesgo primero).
  • totals y segments traen clientes, deuda (capital más moratorios vencidos), atraso promedio, riesgo promedio y recoverable = deuda × (1 − riesgo / 100), una estimación. customers trae las razones que más pesan (top_factors), las señales usadas y los invoice_ids vencidos para actuar sobre ellos.
  • La clasificación se recalcula cada día a las 5:40 y, si tiene más de 6 horas, al consultarla.
Ejemplo de petición 
curl "https://recaudo.app/api/v1/collections/risk-segments?segment=broken_promise&limit=10" \
  -H "Authorization: Bearer sk_live_tu_secret_key"
{
  "object": "collection_risk_segments",
  "data": {
    "currency": "MXN",
    "computed_at": "2026-10-16 05:40:00",
    "totals": { "customers": 120, "debt": 384500.00, "avg_score": 52, "recoverable": 181200.00 },
    "tiers": [{ "key": "critical", "customers": 18, "debt": 96000.00 }],
    "segments": [
      {
        "key": "broken_promise",
        "name": "Promesas incumplidas",
        "customers": 14,
        "debt": 41800.00,
        "debt_share": 10.9,
        "avg_days_overdue": 47,
        "avg_score": 63,
        "recoverable": 15400.00,
        "playbook": { "objective": "…", "tone": "…", "steps": [{ "day": 0, "channel": "call", "action": "…" }], "offer": "…", "avoid": ["…"], "kpi": "…", "message": "…" }
      }
    ],
    "customers": [
      {
        "customer_id": "01234567-89ab-cdef-0123-456789abcdef",
        "score": 71,
        "tier": "high",
        "debt": 6200.00,
        "days_overdue": 52,
        "top_factors": ["age", "broken_promises", "late_history"],
        "invoice_ids": ["89abcdef-0123-4567-89ab-cdef01234567"]
      }
    ]
  }
}
¿Te sirvió esta página? Gracias por avisarnos.
Esc