Back to journal

Coming back from checkout is not the final confirmation

On October 13, I corrected a timing problem on Seasonal.Work's plan page. Someone returning from checkout could see the Free plan because the page loaded before the payment update had finished processing. The display then stayed unchanged until a reload. At the moment when the person most needed a clear answer, the interface could make an unfinished confirmation look like an unsuccessful upgrade.

The change added an explicit waiting state to the shared candidate and employer plan screen. After the checkout return, the page checks the authenticated profile a bounded number of times and explains that confirmation is in progress. During that interval it suppresses another purchase option. The aim is to give the existing transaction time to be reflected in the account, without suggesting that repeating the purchase is the normal way to resolve uncertainty.

The return address itself does not grant access. The page still relies on the plan reported by the server, so a successful-looking return cannot promote an account on its own. If the expected update takes longer than the bounded wait, the interface explains the delay and offers a later refresh. Expired or cancelled checkout states remain distinct. These details keep the feedback useful without turning a loading indicator into a promise that the payment or upgrade has succeeded.

The implementation was merged that day. Focused checks covered delayed activation for both roles, the retry limit, manual refresh, errors, expiry and leaving the page while work was pending. Browser checks exercised the actual component with delayed profile fixtures on desktop and mobile layouts. That establishes the tested display behavior, rather than a real payment result. No backend or account-access rules were changed as part of this correction.

Reflection

A return from an external flow is a transition, not always its conclusion. Seasonal.Work needed to explain the gap between returning and receiving a confirmed account state. A short, bounded wait with an honest next step is more useful than either a stale label or premature reassurance.