Record a recovery payment

A recovery payment records cash received after charge-off. It is deliberately distinct from an ordinary repayment because allocation, income recognition, reporting, and closure rules may differ after charge-off. Repayment commands are internal-only—money on an active loan always moves through the payment API—but on a charged-off loan, recovered cash posts through this governed command.

Cash received after charge-off

CommandPOST /v1/loans/{loanId}/transactions?command=recoverypayment

Case contextRequired on human calls

ApprovalMaker-checker parks it for a second approver

Ledger effectRecovery order: principal, interest, fee, or recovery income

UndoNone — corrected by a new governed action

Only money that already exists

1. Money settlesagency remittance, evidenced in the casewaits
2. Charged-off state checkedrejected on an ordinary active loanautomatic
3. Recovery postsrecovery allocation, not repaymentautomatic
4. Charge-off standsunless an explicit transition says otherwiseautomatic

Example

A charged-off account has $1,340 recoverable balance. A collections agency remits $200 of settled funds.

curl -X POST "$BASE/v1/loans/7204/transactions?command=recoverypayment" \
  -H "Authorization: Bearer $TOKEN" \
  -H "LendEasy-Tenant: demo-lender" \
  -H "LendEasy-Case: case_RECOVERY_31" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: hbr-recovery-2028-03-14" \
  -d '{
    "transactionDate": "2028-03-14",
    "transactionAmount": 200.0,
    "note": "Borrower payment after charge-off via agency remittance 882.",
    "dateFormat": "yyyy-MM-dd",
    "locale": "en"
  }'

{
  "officeId": 1,
  "clientId": 412,
  "loanId": 7204,
  "resourceId": 30533,
  "changes": {
    "transactionDate": "2028-03-14",
    "transactionAmount": 200.0
  }
}

Recovery commands also accept native payment-detail fields recording how the money arrived. Post only settled money, its evidence and source reference held in the case.

Rejected on an ordinary active loan

• The loan is charged off.
• The amount is positive and does not violate over-recovery policy.
• Restrictions and legal status permit acceptance and application.
• The transaction date matches approved backdating policy.

Every execution writes a governance record.

Allocation and accounting

Read the posted transaction for its components: GET /v1/loans/7204/transactions/30533 returns the allocation portions and the remaining balance.

The loan remains charged off unless an explicit, policy-supported undo-charge-off or terminal transition says otherwise.

Correcting a recovery does not undo charge-off

If recovered money itself returns or was misapplied, the correction is a new governed action agreed in the case—linked to the original recovery through governance records—and the original charge-off remains intact.