Canonical checkout-session core for the Aventas Discord bot and website. The website vendors website/src/{adapters,domain,handlers} under functions/api/pay/ and the three SQL migrations under migrations/. The website Worker mounts create, status, cancel, and trusted verify routes; its /checkout/:token page renders the stored UPI recipient and QR. The bot keeps its manual UPI, QR, and screenshot workflow and adds a hosted link only when checkout is enabled and reachable.
A checkout visit, QR scan, screenshot, or public poll never marks an order paid. Only the bot's trusted verification path may call the server-to-server verify endpoint. Staff must independently confirm funds in the merchant bank/PSP account; heuristic email matching is disabled by default and is not proof of settlement. Checkout is disabled by default. Passing tests does not imply staging or production activation.
website/: checkout handlers, SQL store, durable rate limiter, additive migrations, and isolated handler/security tests.bot/: checkout HTTP client and local cross-system tests against the real website handlers and disposable SQLite.frontend/: standalone component, poller, and QR tests for the checkout UI; the website serves its integrated page..github/workflows/checkout-ci.yml: website tests/typecheck, bot and cross-system tests, frontend tests/typecheck.
Run locally:
(cd website && bun install --frozen-lockfile && bun test && bun run typecheck)
(cd bot && python -m pip install aiohttp pytest pytest-asyncio && python -m pytest -q)
(cd frontend && bun install --frozen-lockfile && bun test && bun run typecheck && bun run build)For the live repository state, configuration, staging sequence, acceptance criteria, and rollback, see the staging runbook. The older blocked-work notes have been replaced with a current summary in docs/WORK_REMAINING_BLOCKED.md.
The standalone demo requires Node.js 22.12+ or 24+ for Vite 8. Build assets in frontend/dist/ are generated locally and are not source-controlled; the deployed website owns its own checkout bundle. Run bun audit in both JavaScript packages before release.
Amount-only email parsing and optional decimal reconciliation suggestions are review-only utilities; they cannot mark orders paid. See the amount-only design and the verified PSP contract.
Provider candidate screening is review-only and not a live PSP integration. See staging inventory and provider contract.