Who this is for: studio operators (admin panel) · Product: Podyx V2
Every payment in Podyx has a status and a history, so you always know where money is: waiting, taken, failed or returned. This article covers what those states mean and how to handle refunds well.
🔄 The payment lifecycle
Payments move through clear stages: pending, captured, failed, and refunded. You can see where any transaction sits from the Purchases tab, along with what was bought and the underlying payment provider detail.
Cash payments run through a manual approve or decline queue, so nothing is marked paid until you confirm you actually received it.
A failed card payment at checkout is usually a declined card. The client sees a clear message and can try another card on the same page — see How a Booking Works.
↩️ How refunds work
There are two ways money comes back, and the difference matters:
A money refund is always the full amount. You can issue one at any time from the purchase record, and it goes back out through Stripe or Square. A client who cancels before your booking cut-off time receives a full refund automatically.
To return part of an amount, use store credit. Podyx does not do partial money refunds. If you want to give back half a session fee, or hold something back for a late cancellation, issue that amount as credit on the client's account instead.
Every refund carries a reason. That reason is worth writing properly, because it is what makes sense of your numbers months later when you are looking at why a month came in light.
The cancel and delete dialogs tell you what happens to the money. Before you confirm, the dialog says which credits or card payments Podyx gives back, and what you must still refund outside Podyx — for example money collected in cash or through a payment taken outside Podyx. For a booking paid with both credits and card, the dialog says what happens to the credits and what happens to the card payment. Read it before confirming, so nothing owed to the client is missed.
Credits come back once. Cancelling a booking paid partly with credits and partly by card returns the credits a single time.
⚠️ Before this was fixed, such a cancellation could return the credits twice, mostly at Square studios. Earlier cancellations are not corrected automatically — see Credits for how to check your clients' ledgers.
When you cancel or delete a free studio tour or a free admin booking, the dialog does not promise a refund, because nothing was paid. A booking paid with credits keeps the refund wording.
Once staff remove or cancel a priced session, the old payment link for that booking can no longer be paid, resent or extended.
Deleting the last session of a paid booking keeps its purchase, payment history and add-on purchases, so the money stays on record — see Sessions.
ℹ️ Podyx takes no processing fee, so there is nothing of ours to return on a refund. Your payment processor's own fee on the original charge is generally not returned by Stripe or Square when you refund. Check their terms for the details.
🎟️ Consider credits instead
Before refunding, ask whether credits would serve everyone better. A refund is revenue leaving permanently. A credit keeps the money with you and gives the client a reason to come back. For late cancellations especially, credits turn an awkward moment into a retained customer, and they are also the only way to return a partial amount.
💡 Offer the choice. "I can refund you, or I can put it on your account as credit so it is there whenever you rebook." Most people take the credit.
🛡 Built-in protections
No double charges. Payment creation is idempotent, so a retry or a double-click cannot charge someone twice.
No double refunds. Two refunds of the same payment cannot both go through. A second refund within about two minutes is refused as "in progress" — wait and try again after that if it is really needed.
Card refunded when credits run short. If a client pays for an add-on or a bundle with card plus credits and their credits turn out to be short, the card amount is refunded automatically and checkout tells them so. The client is never left charged with nothing received.
Provider webhooks keep Podyx in step with Stripe and Square, so statuses stay accurate without you refreshing anything.
Multi-currency support, set per studio.
🧠 Why it matters
You always know what is owed and what has actually landed.
Refund reasons turn into insight rather than a gap in your reporting.
Credits protect revenue that a refund would send away for good.
✅ Summary
Watch payments move from pending to captured in Purchases, and approve cash manually. A declined card at checkout shows the client a clear message and lets them try another card. Money refunds are always for the full amount and can be issued at any time, while cancellations before your cut-off refund in full automatically. A second refund of the same payment within about two minutes is refused as in progress, and if credits run short during a card-plus-credits payment, the card amount is refunded automatically. The cancel and delete dialogs say which credits or card payments Podyx gives back and what you still need to refund outside Podyx, including for bookings paid with both credits and card, whose credits now come back once — earlier double returns are not corrected automatically. Once a priced session is removed or cancelled, its old payment link can no longer be used, and deleting a paid booking's last session keeps its purchase and payment history. Cancelling or deleting a free studio tour or free admin booking promises no refund, while a booking paid with credits keeps the refund wording. To give back part of an amount, issue store credit instead, which keeps the money and the client with you.
Related: Credits · Purchases · Sessions · Connect Your Payments · Invoicing · How a Booking Works
