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.

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 when the tenant records how the money arrived. Post only settled money: the command records cash that already exists, with the settlement evidence and source reference held in the case.

Eligibility

• The loan is charged off; the command is rejected on an ordinary active loan.
• The amount is positive and does not violate over-recovery policy.
• The money is settled and not already recorded.
• Restrictions and legal status permit acceptance and application.
• The transaction date matches approved backdating policy.

A human call carries LendEasy-Case naming an open case when case management is enabled; every execution writes a governance record, and maker-checker can park the command for a second approver.

Allocation and accounting

The product defines recovery allocation—principal, interest, fee, or recovery-income order—and the corresponding accounts. 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. Receiving a recovery does not pretend charge-off never happened.

Reversal

There is no undo command for a recovery payment. 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.