Recaudo Docs
Criar conta

Pagamentos e clientes

Cobrança

Risco e faixas de atraso

Classifica a carteira em atraso: cada cliente com saldo vencido recebe uma pontuação de risco de 0 a 100 (mais alta = mais difícil de recuperar) e entra em uma faixa de atraso conforme o comportamento. Cada faixa traz seu playbook pré-carregado: objetivo, tom, passos por dia e canal, oferta, o que evitar, como medir e uma mensagem base.

GET /api/v1/collections/risk-segments
Campo Tipo Descrição
segmentstringOpcional. Uma faixa: legal_hold, promise_active, broken_promise, disputing, unreachable, chronic_late, early_reliable, engaged_no_pay, over_one_year, deep_arrears ou developing. Com ela a resposta inclui customers.
limitintegerClientes da faixa (padrão 20, máximo 50).
sortstringdebt (maior dívida primeiro, padrão) ou score (maior risco primeiro).
  • totals e segments trazem clientes, dívida (principal mais juros de mora vencidos), atraso médio, risco médio e recoverable = dívida × (1 − risco / 100), uma estimativa. customers traz os motivos que mais pesam (top_factors), os sinais usados e os invoice_ids vencidos para agir sobre eles.
  • A classificação é recalculada todos os dias às 5:40 e, se tiver mais de 6 horas, ao consultá-la.
Exemplo de requisição 
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": "Promessas descumpridas",
        "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"]
      }
    ]
  }
}
Esta página ajudou? Obrigado por avisar.
Esc