Payment Status
·article·2026-06-12
Payment Status
Definition
The stored fact recording whether a cost has been settled: PAID or UNPAID. Written at the moment of the business event, never derived at query time.
Worked Example
Pay Now flow:
Cost item created -> expense recorded
Withdrawal created -> bank balance reduced
payment_status = PAID (all in one atomic transaction)
Pay Later flow:
Cost item created -> expense recorded
payment_status = UNPAID
liability_type = AP or ACCRUED
Interpretation & Pitfalls
A stored status is evidence ("set by user X at time T"); a computed status is an argument that changes whenever the code does. Financial systems store facts. See: stored-vs-computed.
In TupicFinance
payment_status is stored explicitly and updated transactionally together with the matching bank movement.