Real-World Example
Jane wants to pay more than the next installment amount. The portal should apply the extra payment to the account balance and adjust remaining scheduled payment amounts or calendar events as needed.Visual Flow
Bank (ACH) Payments
Jane has two $100 installments left and a $300 balance. She pays $150 extra from her checking account. The same rules apply when she uses Pay Now, a partial payment, or Pay Remaining Balance from a bank account.- Until the bank transfer settles, the payment is processing and nothing is applied yet.
- When it settles, the first installment is paid, the second drops to $50, and her balance goes to $150.
- The payment is then checked once a day for 60 days in case her bank returns it.
- If her bank returns it, the payment is reversed automatically, exactly once:
- The payment is marked failed, and Jane gets the failed-payment message.
- The installment it paid goes back to unpaid with its calendar event, and the installment it partly paid gets its $50 back (both are $100 again).
- Her balance goes back to $300. If the payment had settled the account, it returns to an active payment plan.
- An installment that is already past due is charged in the next nightly run, like any other due installment.
How It Should Work
- It should validate extra payment amount and payment method before processing.
- It should allocate successful payment correctly across the schedule.
- It should update remaining payment amount, history, and calendar event amount where needed.
- It should reverse a returned bank payment once: restore the installments it paid or partly paid, the balance, and the calendar, and tell the consumer it failed.
How It Should Not Work
- It should not overpay a completed account without a clear rule.
- It should not update the schedule before payment success is confirmed.
- It should not leave calendar amounts stale after allocation changes.
- It should not leave a returned bank payment counted as paid, or reverse the same return twice.
- It should not undo installments the consumer has changed or paid since the returned payment.

