In the KiddyCash ecosystem, trust is built on accuracy. Whether a child is spending virtual coins in a family simulation or real-world currency at a school canteen, the ledger must always reflect reality in real-time.
To maintain this integrity, we implement a strict, universal rule: All pending transactions must be approved or declined within 1 hour.
If the clock runs out, the transaction expires.
Why 1 Hour?
We chose a 60-minute window for three critical reasons:
1. Preventing “Ghost” Transactions
A pending transaction is a commitment of intent. When a child initiates a payment, they are asking for a slice of the family or institutional budget. Leaving these requests open indefinitely would lead to “ledger bloat”—a cluttered dashboard full of old requests that may no longer be relevant. If a child made a mistake at a shop three days ago, you wouldn’t want that request suddenly popping up for approval today.
2. Real-Time Balance Accuracy
For real-money transactions (is_virtual = false), a pending request often “earmarks” funds. To ensure that parents and managers always have an accurate view of their actually spendable balance, we cannot leave funds in a “pending” limbo for too long. The 1-hour limit ensures that funds are either committed or released back to the available pool quickly.
3. Encouraging Active Engagement
KiddyCash is an educational tool. The “Pending” state is a moment for a conversation between a child and a guardian (or a customer and a manager). By giving this moment a lifespan, we encourage active financial participation and timely decision-making.
Universal Expiration
It is important to note that this rule is universal. It applies to:
- Family Transactions: When a kid asks a parent for money.
- Ledger Mode: When a student pays a school bursar via a virtual account.
- Real-Money Payments: When a kid swipes their card at a business and waits for parent approval.
What Happens When a Transaction Expires?
When a transaction hits the 1-hour mark:
- Status Change: The status in the ledger moves from
PendingtoExpired. - Funds Released: Any earmarked funds are immediately returned to the sender’s spendable balance.
- Notification: Both the sender and the receiver receive a notification that the transaction has timed out.
Tips for Avoiding Expiration
We understand that parents and managers are busy. Here is how you can ensure transactions go through smoothly:
- Enable Instant Notifications: Make sure KiddyCash has permission to send push alerts so you never miss an approval request.
- Use Smart Approvals: For recurring or low-value transactions, set up Smart Approval rules to authorize payments automatically.
- Re-Initiate Quickly: If a transaction expires, don’t worry. The child can simply re-send the request in seconds.
The 1-hour rule is one of the many guardrails we’ve built to ensure KiddyCash remains the most reliable and transparent financial literacy platform for the next generation.