wellworn

Billing

Paddle is the merchant of record; where invoices and cards live, how the portal opens, and the refund window.

Wellworn does not process payments. Our order process is conducted by our online reseller Paddle.com, which is the Merchant of Record for all our orders. Card details, invoices, and tax are held by Paddle, never by us; the only payment data in our database is the Paddle customer id and subscription id on the plan row.

The billing page

/app/billing shows four figures: the plan and its seat count, the monthly cap with the burst under it, the credit balance, and the billing period date. The date reads "Renews on" while the subscription is active, "Payment failed, access until" when it is past due, and "Canceled, access until" after a cancellation. An organization that has never been billed shows no date and the note that the free tier never expires.

The page is not in the dashboard tab bar yet; open the URL directly.

The portal

The button on that page posts to /api/paddle/portal, which asks Paddle for a one-time portal session for your organization's customer id and redirects you into it. The customer id is read from your plan row rather than from the request, so the link can only ever open your own account.

Inside the portal you can update the card, download every invoice, change the seat count, and cancel. The button only appears once the organization has been billed at least once; before that there is nothing for Paddle to show.

Tax

Paddle sells to you as an authorised reseller, so the tax on the sale is Paddle's to charge and the invoice comes from Paddle. The price you are charged includes any applicable taxes. A business that was charged a consumption tax it should not have paid can ask Paddle for that portion back by giving a valid sales tax code, or in the US a tax exempt certificate; section 7 of the buyer terms is the clause that covers it.

Verified 2026-09-08 against www.paddle.com

Refunds

Any subscription payment, monthly or yearly, renewal included, and any credit pack can be refunded in full within 14 days of the charge, with no reason required. Ask by mailing support@wellworn.dev from the address you used at checkout, or use Paddle's own form at paddle.net with your order number. Paddle returns the money to the original payment method, usually in 5 to 10 business days depending on the bank.

A refunded subscription drops the organization to the free tier at once, rather than at the end of the period. A refunded credit pack removes the unused credits. Requests after 14 days are read case by case; an outage on our side or a duplicate charge is always refunded. The full text is on the refund policy page.

How a payment reaches your plan

Paddle posts each subscription and transaction event to our webhook. The body is verified against the Paddle-Signature header with HMAC-SHA256 and rejected if its timestamp is more than five minutes off ours. The delivery, the change it makes, and the mark that says it was processed all commit in one transaction keyed on the Paddle event id, so a retried delivery is recorded once and applied once.

If a payment goes through and the dashboard still shows the old plan a minute later, the entitlement cache is the likely reason: it holds for 60 seconds and is cleared as soon as an event applies. Longer than that means the event did not reach us, and support@wellworn.dev can look up the event id.