Minctrl Docs
Cookbook

Debt collection

Run compliant outreach and negotiate a plan on the collections vertical — a manager signs legal escalation and settlements before any adverse action is executed.

Scenario. Delinquent accounts are segmented and sent a §1006.34 validation notice. Early-stage accounts run compliant omnichannel outreach automatically; serious or disputed accounts are validated and a settlement is sized, but a manager must sign the legal-escalation / settlement terms before anything binding happens.

Vertical: collections · Parks at gate step-id: signoff (gate:collections-signoff).

1. Start the run

RUN=$(curl -s -X POST "$API/process-runs" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "vertical": "collections",
    "inputs": {
      "account_id": "A-55012",
      "balance": 4200.00,
      "days_delinquent": 95,
      "disputed": true
    }
  }')
RUN_ID=$(echo "$RUN" | jq -r .id)

The run sends the validation notice, tiers the account, and — for a serious/disputed account — validates the dispute, sizes a settlement, and parks at the manager gate.

2. Read where it parked

curl -s "$API/process-runs/$RUN_ID" -H "Authorization: Bearer $TOKEN"

status is awaiting_human; the run parked at the signoff step.

3. Resume — the manager signs

curl -s -X POST "$API/process-runs/$RUN_ID/resume" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "gate": "signoff",
    "decision": "settlement approved"
  }'

The downstream gateway routes on the manager's verdict — settlement approved posts the agreed plan; an adverse-action verdict routes through the §1006.30 pre-furnishing gate first.

4. Outcome

On an approved settlement the run posts the agreed payment plan and logs every contact for compliance defensibility. If the manager instead approves an adverse action, the run runs the §1006.30 pre-furnishing check and then executes the credit-bureau furnishing. An early-stage, current-balance account never reaches the gate — it stays in automated compliant outreach.

Governance note

The adverse-action step (credit-bureau furnishing) is reversible: false — you can't un-report to a bureau — and stays shadowed until a connector opts in. The signoff gate collects the manager's verdict, and the pre-furnishing gate adds a second check, before that irreversible action fires.

On this page