Changelog

All notable changes to Generous.nz are recorded here, grouped by version. Every deployed build has a version number, a git tag, and an entry below.

Versioning scheme

Versions follow MAJOR.MINOR.PATCH:

0.x — pre-launch. Minor bumps mark a completed build phase or major feature set; patches are bug fixes on the current build.
1.0.0 — first public launch.
1.x+ — post-launch: minor = new features, patch = fixes, major = breaking changes or significant re-architecture.

Each version is tagged in git (v0.2.0) and the current version is kept in package.json. See docs/version-control.md for how to cut a release.

Automatic fee protection on refunds and lost chargebacks. When a refund or dispute is processed (via the daily reconciliation sync or an admin refund), the fundraiser's platform fee on the refunded amount is credited against their next platform-fee invoice (platformFeeCreditCents), so no one pays a fee on money they no longer have. This sits alongside the existing automatic behaviour: the fundraiser's commission is cancelled or credited (fundraiser ↔ wholesaler reversal), the wholesaler's platform fee is credited, and the community campaign's commission on refunded direct sales is cancelled the same way. Idempotent — credits apply only on the transition to refunded/lost.

Recurring donation renewals are now fully automatic. Stripe does not allow the platform to configure webhooks on sellers' connected accounts (verified against the API), so the daily reconciliation job now polls each seller's paid subscription invoices and records every renewal as a PAID donation — idempotent (deduped by the renewal PaymentIntent), with a donor receipt and subscription status kept in sync. No seller webhook secret required.

Legal sign-off marked complete: the platform owner accepted the positions in the sign-off pack (sections 3, 4 and Flow 3c — community campaign commission income) on 27 August 2026. The runbook no longer lists it as a go-live blocker; external accountant/lawyer sign-off remains optional for records.

Removed the redundant "business still pays its usual 5% + GST platform fee" phrasing from the community campaign sections of the legal documents (Wholesaler Agreement, Fundraiser Agreement, ToS and the accountant sign-off pack). The platform-fee obligation is already covered by the general fee clauses in each document.

Removed the "Generous.nz Community Campaign" topic from the help centre and trimmed the direct-sales help copy (no "5% + GST platform fee" phrasing in the fund/commission help topics). The fee obligation remains in the legal agreements, where it actually applies.

Test runbook cleanup step clarified: a fully successful run must end with all test orders/products/listings/accounts removed; a failed run should be troubleshot and fixed first (keeping the test data as evidence) and only cleaned up after the issue is resolved.

Fundraiser purchase attribution cookie (5 days, first-touch): visiting a fundraiser page now saves that fundraiser, so a direct "Buy now" purchase of a wholesale product they've added credits them — even without a ?from= link. Otherwise direct sales still route through the Generous.nz Community Campaign.

Test runbook updated with a community campaign section (Step 4B): how to create and pay a direct "Buy now" order, verify the order/settlement attach to the Fund with the right commission, check referred-sale attribution and the fundraiser opt-out, and confirm the Fund is never platform-fee invoiced. Limitations now note the Fund's own live Stripe account and the Flow 3c legal sign-off as go-live steps.