feat: add refund policy and acceptable use policy pages

routes/static_routes.py

@@ -116,6 +116,33 @@ async def terms_of_service(request: Request) -> Response:
     )
 
 
+@router.get("/docs/refund-policy")
+@router.get("/legal/refund-policy")
+@router.get("/refund-policy")
+@router.get("/refund")
+@limiter.exempt
+async def refund_policy(request: Request) -> Response:
+    return templates.TemplateResponse(
+        request,
+        "legal/refund-policy.html",
+        {"host_url": str(request.base_url)},
+    )
+
+
+@router.get("/docs/acceptable-use-policy")
+@router.get("/legal/acceptable-use-policy")
+@router.get("/acceptable-use-policy")
+@router.get("/acceptable-use")
+@router.get("/aup")
+@limiter.exempt
+async def acceptable_use_policy(request: Request) -> Response:
+    return templates.TemplateResponse(
+        request,
+        "legal/acceptable-use-policy.html",
+        {"host_url": str(request.base_url)},
+    )
+
+
 @router.get("/docs/{path:path}")
 @limiter.exempt
 async def docs_wildcard(path: str, request: Request) -> Response:

shared/reserved_aliases.py

@@ -17,8 +17,11 @@
 RESERVED_ALIASES: frozenset[str] = frozenset(
     {
         "about",
+        "acceptable-use",
+        "acceptable-use-policy",
         "api",
         "apps",
+        "aup",
         "auth",
         "billing",
         "blog",
@@ -59,6 +62,8 @@
         "profile",
         "profile-pictures",
         "public",
+        "refund",
+        "refund-policy",
         "register",
         "restore-account",
         "relay",

templates/legal/acceptable-use-policy.html

@@ -0,0 +1,96 @@
+{% extends "legal/base.html" %}
+
+{% block title %}Acceptable Use Policy - spoo.me{% endblock %}
+
+{% block content %}
+    <span><img alt="Shield emoji" class="emoji"
+            src="https://raw.githubusercontent.com/microsoft/fluentui-emoji/main/assets/Shield/Flat/shield_flat.svg"></span>
+    <h1>Acceptable Use Policy</h1>
+    <br>
+
+    <p>Effective 2026-09-XX.</p>
+
+    <p>This policy says what you may not do with spoo.me. It applies to every link, custom domain, API key, connected app, and account, free or paid. It is part of our <a href="/terms-of-service">Terms of Service</a>. If you break it, we may block your links, slow your account down, or close it.</p>
+
+    <br>
+
+    <h2 id="links-you-may-not-create">Links you may not create</h2>
+
+    <p>Do not shorten, share, or promote links that:</p>
+
+    <ul>
+        <li>lead to phishing, malware, or pages built to deceive, such as fake login pages, fake stores, or fake virus warnings</li>
+        <li>are used for spam, unsolicited bulk messaging, or other commercial abuse</li>
+        <li>point to illegal content, or break the laws that apply to you or to the people you send there</li>
+        <li>infringe copyright, trademarks, or other rights of others</li>
+        <li>harass, threaten, or defame a person</li>
+        <li>exist to get past filters such as Google Safe Browsing, Spamhaus, PhishTank, or similar, including by creating fresh links faster than they can be flagged</li>
+    </ul>
+
+    <br>
+
+    <h2 id="every-destination-is-checked">Every destination is checked</h2>
+
+    <p>We screen every destination when a link is created and again over its lifetime. That includes the destination for each country when you set geo rules, every variant of a link, links behind a password, and links on custom domains.</p>
+
+    <p>Screening uses our own rules plus outside sources. We may block, remove, or report a link on our own judgement, even if no outside blocklist has flagged it yet. A blocked link shows a notice instead of redirecting.</p>
+
+    <br>
+
+    <h2 id="your-account">Your account</h2>
+
+    <ul>
+        <li>Keep your login and API keys to yourself. Do not share them.</li>
+        <li>Do not create extra accounts to get around a limit or a ban.</li>
+        <li>Do not try to get into other accounts or into our systems.</li>
+        <li>Do not scrape, overload, probe, or otherwise interfere with the service.</li>
+        <li>Do not work around rate limits or security measures.</li>
+        <li>Use the API for your own projects. Do not resell or redistribute API access.</li>
+    </ul>
+
+    <br>
+
+    <h2 id="paid-plans">Paid plans</h2>
+
+    <p><strong>No reselling.</strong> Pro is for you and your own projects or business. Do not sell access to your account, offer spoo.me link creation as a paid service of your own, or sublicense the API. If you want to build a product on top of spoo.me, email us first.</p>
+
+    <p><strong>Unlimited links, in good faith.</strong> There is no cap on how many links you create for real use. Automated use that looks like abuse, such as link farms, creating and discarding links at machine speed, or using us as a load-testing target, may be throttled. Throttling slows down creating new links. It never stops your existing legitimate links from redirecting.</p>
+
+    <p><strong>Custom domains you own.</strong> You may only connect a domain you own or are authorised to manage, and we verify that through DNS. Do not connect a domain that impersonates a brand, a person, or a service you do not represent. If a domain stops being yours, links on it stop and we may remove it.</p>
+
+    <p><strong>Screening still applies.</strong> Paying for Pro does not exempt any destination, geo rule, or variant from the checks above.</p>
+
+    <br>
+
+    <h2 id="what-we-do-about-it">What we do about it</h2>
+
+    <p>Depending on how serious it is, we may warn you, throttle your account, block the links involved, or suspend or close the account. When people are being harmed, we act first and tell you afterwards. Where the law requires it or the harm is serious, we report to the relevant authorities and blocklists.</p>
+
+    <p>If you think we got it wrong, email <a href="mailto:support@spoo.me">support@spoo.me</a> with the link and we will look again.</p>
+
+    <br>
+
+    <h2 id="reporting-abuse">Reporting abuse</h2>
+
+    <p>If you find a spoo.me link that breaks this policy, report it at <a href="/report">spoo.me/report</a> or email <a href="mailto:support@spoo.me">support@spoo.me</a>. Reports are handled ahead of everything else.</p>
+
+    <br>
+
+    <h2 id="governing-law">Governing law</h2>
+
+    <p>This policy is part of our <a href="/terms-of-service">Terms of Service</a> and follows the same governing law, the laws of the Netherlands. If you live in the EU, nothing here affects your rights under the consumer protection laws of your country of residence.</p>
+
+    <br>
+
+    <h2 id="changes-to-this-policy">Changes to this policy</h2>
+
+    <p>We may update this policy. When we do, we change the effective date at the top, and we notify registered users of changes that matter.</p>
+
+    <br>
+
+    <h2 id="contact">Contact</h2>
+
+    <p>Questions about this policy go to <a href="mailto:support@spoo.me">support@spoo.me</a>.</p>
+
+    <p>Support Team, spoo.me</p>
+{% endblock %}

templates/legal/refund-policy.html

@@ -0,0 +1,97 @@
+{% extends "legal/base.html" %}
+
+{% block title %}Refund Policy - spoo.me{% endblock %}
+
+{% block content %}
+    <span><img alt="Receipt emoji" class="emoji"
+            src="https://raw.githubusercontent.com/microsoft/fluentui-emoji/main/assets/Receipt/Flat/receipt_flat.svg"></span>
+    <h1>Refund Policy</h1>
+    <br>
+
+    <p>Effective 2026-09-XX.</p>
+
+    <p>This policy covers payments for spoo.me Pro. It is short on purpose. If anything is unclear, email <a href="mailto:support@spoo.me">support@spoo.me</a> and a person will answer.</p>
+
+    <br>
+
+    <h2 id="who-charges-your-card">Who charges your card</h2>
+
+    <p>Paddle is our Merchant of Record. Paddle is the seller on your receipt, collects the payment, and handles any sales tax or VAT owed where you live. Paddle also issues refunds on our behalf. The charge on your bank statement shows Paddle's name next to spoo.me.</p>
+
+    <p>Prices on our pricing page are before tax. Paddle adds any tax at checkout based on your location.</p>
+
+    <br>
+
+    <h2 id="what-pro-costs">What Pro costs</h2>
+
+    <ul>
+        <li><strong>Pro monthly:</strong> $15 a month. It renews every month until you cancel.</li>
+        <li><strong>Pro annual:</strong> $144, paid once for 12 months. It does not renew. We remind you before the year ends, and you buy another year if you want to keep Pro.</li>
+        <li><strong>Founding price:</strong> early subscribers pay $9 a month or $90 a year. Everything on this page applies to them the same way.</li>
+    </ul>
+
+    <br>
+
+    <h2 id="14-days-no-questions">14 days, no questions</h2>
+
+    <p>You can get a full refund within 14 days of your first payment, on both the monthly and the annual plan. You do not need to give a reason.</p>
+
+    <p>To ask for one, email <a href="mailto:support@spoo.me">support@spoo.me</a> from the address on your account with "Refund" in the subject. We ask Paddle to refund the charge, and Paddle sends the money back to the payment method you used. Banks usually show it within 5 to 10 business days.</p>
+
+    <p>Your plan goes back to Free as soon as the refund is issued. Nothing is deleted. Your links keep redirecting, your click data stays, and your account stays. Pro-only features turn off, as described under <a href="#going-back-to-free">Going back to Free</a>.</p>
+
+    <p>The 14 days count from your first payment. Monthly renewals are not refundable, but you can cancel before a renewal and you will not be charged again.</p>
+
+    <br>
+
+    <h2 id="after-14-days">After 14 days</h2>
+
+    <p><strong>Monthly.</strong> Cancel any time from Billing in your dashboard or by emailing us. Pro stays on until the end of the month you already paid for, then your account goes to Free. There are no further charges. We do not refund the remaining days of a month.</p>
+
+    <p><strong>Annual.</strong> The prepaid year is non-refundable after the first 14 days. Pro stays on until the 12 months end, plus a 14-day grace window so you have time to buy another year. Because the year does not renew, there is nothing to cancel and no surprise charge.</p>
+
+    <br>
+
+    <h2 id="switching-plans">Switching plans</h2>
+
+    <p>To move from monthly to annual, buy the annual plan. Your monthly subscription ends at the close of the period you already paid for, and the annual plan starts from its purchase date. We do not prorate.</p>
+
+    <br>
+
+    <h2 id="failed-payments">Failed payments</h2>
+
+    <p>If a monthly renewal fails, Paddle retries the card for a few days and emails you. If the payment still cannot be collected, the subscription ends and your account goes to Free under the same rules as below.</p>
+
+    <br>
+
+    <h2 id="going-back-to-free">Going back to Free</h2>
+
+    <p>Whether Pro ends through a refund, a cancellation, or a year running out, the same things happen:</p>
+
+    <ul>
+        <li>Nothing is deleted. Your links, click data, QR codes, and settings stay in your account.</li>
+        <li>Links on spoo.me keep redirecting.</li>
+        <li>Pro-only features turn off. Free plan limits apply to anything new you create.</li>
+        <li>Custom domains are a Pro feature. Links on your custom domains stop resolving after the grace window. We keep your domain settings and those links for 90 days. If you come back to Pro within that time, everything resolves again without any setup. After 90 days we may remove the domain configuration.</li>
+    </ul>
+
+    <br>
+
+    <h2 id="your-rights">Your rights</h2>
+
+    <p>This policy is part of our <a href="/terms-of-service">Terms of Service</a> and follows the same governing law, the laws of the Netherlands. If you live in the EU, nothing here affects your rights under the consumer protection laws of your country of residence.</p>
+
+    <br>
+
+    <h2 id="changes-to-this-policy">Changes to this policy</h2>
+
+    <p>We may update this policy. When we do, we change the effective date at the top, and we email paying subscribers about changes that affect them.</p>
+
+    <br>
+
+    <h2 id="contact">Contact</h2>
+
+    <p>Questions about a charge or a refund go to <a href="mailto:support@spoo.me">support@spoo.me</a>. Put "Refund" in the subject and we will find your payment faster.</p>
+
+    <p>Support Team, spoo.me</p>
+{% endblock %}

tests/integration/test_static_routes.py

@@ -181,6 +181,36 @@ def test_terms_of_service_alias():
     assert "text/html" in resp.headers["content-type"]
 
 
+def test_refund_policy_renders():
+    app = _build_test_app()
+    with TestClient(app) as c:
+        resp = c.get("/refund")
+    assert resp.status_code == 200
+    assert "Paddle is our Merchant of Record" in resp.text
+
+
+def test_refund_policy_alias():
+    app = _build_test_app()
+    with TestClient(app) as c:
+        resp = c.get("/legal/refund-policy")
+    assert resp.status_code == 200
+
+
+def test_acceptable_use_policy_renders():
+    app = _build_test_app()
+    with TestClient(app) as c:
+        resp = c.get("/acceptable-use")
+    assert resp.status_code == 200
+    assert "Every destination is checked" in resp.text
+
+
+def test_acceptable_use_policy_alias():
+    app = _build_test_app()
+    with TestClient(app) as c:
+        resp = c.get("/aup")
+    assert resp.status_code == 200
+
+
 # ── Contact ──────────────────────────────────────────────────────────────────
 
 

tests/smoke/test_routes_registered.py

@@ -124,6 +124,11 @@ def test_all_expected_paths_registered(smoke_app: FastAPI) -> None:
         "/privacy",
         "/tos",
         "/terms-of-service",
+        "/refund",
+        "/refund-policy",
+        "/acceptable-use",
+        "/acceptable-use-policy",
+        "/aup",
         "/docs/{path:path}",
         "/contact",
         "/report",