amountPaid is the running sum of all payments logged against this invoice. You don't edit it directly — it goes up each time you record a payment. The difference between the total due and the amount paid is the balance still owed.
This is read-only. To increase it, record a payment; that's what keeps the number honest.
Technical section
Data model, API, and internals — visible to developers.