Insights

Why Purser treats your paydown goal as a promise

A paydown goal is easy to set and easy to forget. Here is how Purser keeps it set aside first, how it decides a goal is on track, at risk, missed or met, and why safe to spend is allowed to go negative.

Most budgeting apps let you set a goal and then quietly ignore it. The goal sits in a settings screen. The spending number on the home screen never mentions it. A month later the goal is gone and nobody can say when it went.

Purser’s goal is different. It is a number you commit to before the pay period starts, and it comes out of the budget first. This post walks through what that means in practice, how the app decides whether you are keeping the promise, and why the safe to spend figure can show a minus sign.

If you have not read How Purser decides what is safe to spend, it explains where the card payment and the other pieces come from. This post picks up where that one stops.

The goal comes off the top

Purser is built for one pattern. Pay lands in checking. Most of it goes onto one credit card. You spend on that card until the next payday.

The paydown goal is the part of that card payment you have decided to pay down rather than spend. Say the card payment this period was $2,000 and your goal is $300. Purser does not wait to see whether you have $300 left over at the end. It takes the $300 out at the start.

The budget for the period is the card payment, minus the goal, minus the recurring charges still due on the card before payday. Safe to spend is that budget minus what you have already charged.

Here is a worked example with made-up numbers.

  • Card payment this period: $2,000
  • Paydown goal: $300
  • Bills still due on the card: $500
  • Budget: $2,000 minus $300 minus $500, which is $1,200

If you have charged $1,000 so far, safe to spend is $200. The goal is untouched, because the goal was never part of the $1,200.

Four states, and one rule for each

The goal always has a state. There are four, and the app can say which one you are in.

On track. Safe to spend is zero or more. You have not touched the goal.

At risk. Spending, plus the bills still due, has used up the whole budget and started eating into the goal. The app tells you how much of the goal is gone.

Missed. Spending has eaten all of it.

Met. Only when a matching paydown has actually posted.

The order matters. The goal is set aside first, so spending only reaches it once the rest of the budget is gone. In the example above, the budget is $1,200. If you charge $1,350, you are $150 past the budget. That $150 comes out of the goal. Purser calls the goal at risk and says $150 of $300 is already spent. If you charge $1,700, you are $500 past the budget. The goal is only $300, so all of it is gone, and the state is missed.

The code is a small function of three things: the goal, the signed budget that remains, and whether a paydown has posted. It has no network calls and no database. It takes numbers and returns a state with a sentence.

What counts as met

This is the part we were most careful about. A goal is not met because you intended to meet it. It is met when the money moved.

Purser counts two things.

  1. A transfer out of any account that you tagged as a paydown goal, or a savings transfer whose payee says “paydown goal”, of at least the goal amount this period.
  2. At payday, when the period closes, a card payment that is larger than the period’s real charges by at least the goal.

The second one covers the person who does not make a separate transfer. If the card payment at payday is bigger than what you spent on the card by at least the goal, then you did pay it down, whether or not you used a special tag.

Until one of those is true, the goal is on track, at risk or missed. It is never quietly marked as done.

Why safe to spend can be negative

A number that stopped at zero would look tidy and hide the most important fact. Zero says “you have nothing left”. It does not say “you are over”.

So the number is signed. Below zero, it reads as how far over you are. The sentence under the number says the same thing in words, and shows what was spent against what payment and goal.

The only cap goes the other way. Safe to spend is never more than the credit still open on the card, which is the limit minus the balance. A number that tells you to spend more than the card will allow is worse than no number.

One row a day, so the question has an answer later

A goal that is missed should not be a mystery. Purser writes one history row a day for the household. It holds the day’s signed safe to spend, what was spent, the state of the goal, the amount at risk and the warnings that applied. A second write on the same day replaces the first, so there is never more than one row per day.

That small table answers questions the Today screen cannot. When did it first go negative? How long was the goal at risk before it was missed? On payday, the row also holds how the period before it closed out, which is why the app can say “Goal missed by” and an amount, instead of only telling you the present state.

Warnings fire once

The same figures drive the warnings. There are three. One at 80 percent of the budget used. One at 100 percent. One when the goal goes at risk.

Each warning has an id, and the id includes the start date of the pay period. That is deliberate. It means a warning can fire once per period and no more. Two weeks later, the 80 percent warning can fire again because it is a different period and a different id. We cover how those warnings reach your phone in a separate post about notifications.

The pace line uses the same numbers. It says, for example, that you have used a share of the period’s budget with a share of the period left. The two percentages are measured against the same period, so the line cannot say something the number contradicts.

What the goal is not

It is not a promise Purser keeps for you. Purser cannot move money. It will not make the transfer. Every payment stays in your bank’s own app. All the goal does is refuse to let you lose track of a decision you made.

That is the whole design. You decide the amount. Purser takes it off the top, watches it, and tells you the truth when you drift. It does not nag and it does not act. The decision, and the tap in your bank’s app, are yours.

You can try the shape of this on your own numbers in the Safe to Spend Calculator. It runs in your browser and sends nothing anywhere.

Drafted with AI assistance.