ÁSZF: terms page, consent on every purchase, confirmation e-mail
CI / test (push) Successful in 1m28s
CI / build (push) Successful in 5m29s
CI / deploy (push) Skipped

The new /aszf page holds the terms (a draft for legal review; the
company data come from lib/legal.ts). Stripe's payment page asks every
buyer to accept them and to ask for immediate delivery, giving up the
14-day withdrawal right; the time and the terms version are stored, and
a purchase_confirmation e-mail confirms it. Login, the landing footer,
the package cards and the sitemap link the terms.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
This commit is contained in:
feco
2026-11-20 12:06:10 +00:00
co-authored by Claude Opus 5.5
parent ac5e7fa4fd
commit e326095f3f
14 changed files with 409 additions and 12 deletions
+16
View File
@@ -202,6 +202,22 @@ impl Source {
}
impl Package {
/// What the package gives, as a phrase: "2 részletes képletelemzés, 1 kapcsolati elemzés, …".
pub fn contents_text(&self) -> String {
[
(self.natal, "részletes képletelemzés"),
(self.synastry, "kapcsolati elemzés"),
(self.forecast, "éves előrejelzés"),
(self.persons, "személyhely"),
(self.questions, "kérdés"),
]
.into_iter()
.filter(|&(n, _)| n > 0)
.map(|(n, what)| format!("{n} {what}"))
.collect::<Vec<_>>()
.join(", ")
}
/// The invoice item: a name that says what the service is (online,
/// software-made content; no profession implied), and what the package
/// contains (Áfa tv. 169. § e).
+1 -1
View File
@@ -16,7 +16,7 @@ mod invitations;
mod invoices_user;
mod jobs;
mod models;
mod payments;
pub(crate) mod payments;
mod promo;
mod prompts;
mod questions;
+77 -1
View File
@@ -84,6 +84,9 @@ pub fn method(config: &crate::config::Config) -> Option<&'static str> {
}
}
/// The terms (ÁSZF) version a purchase accepts; the frontend's `TERMS_UPDATED`.
pub const TERMS_VERSION: &str = "2026-11-20";
/// Only admins can buy through Stripe: until purchases open, and always with a
/// test key (nobody gets packages with Stripe's test cards, nobody types a
/// real card into a test page).
@@ -149,6 +152,18 @@ pub async fn checkout(
field("metadata[user_id]", &auth.id().to_string()),
field("payment_intent_data[description]", &format!("Sorsfonalak – {}", package.name)),
field("payment_intent_data[metadata][package]", package.id),
// Every purchase accepts the terms and asks for immediate delivery,
// giving up the 14-day withdrawal right (45/2014. Korm. rendelet 29. §).
// Stripe needs the terms URL in its dashboard (Public details) for this.
field("consent_collection[terms_of_service]", "required"),
field(
"custom_text[terms_of_service_acceptance][message]",
&format!(
"Elfogadom az [ÁSZF-et]({}/aszf), kérem a szolgáltatás azonnali megkezdését, és tudomásul veszem, \
hogy ezzel elveszítem a 14 napos elállási jogomat.",
state.config.public_base_url
),
),
field("success_url", &format!("{back}?fizetes={{CHECKOUT_SESSION_ID}}")),
field("cancel_url", &format!("{back}?fizetes=megszakitva")),
];
@@ -195,17 +210,24 @@ async fn complete(state: &AppState, session: &stripe::Session) -> Result<bool, A
}
None => None,
};
if !session.terms_accepted() {
tracing::warn!(session = %session.id, "paid without the terms consent");
}
sqlx::query(
"UPDATE stripe_checkouts SET completed_at = now(), order_id = $2, payment_intent = $3, amount_huf = $4, \
customer = $5 WHERE id = $1",
customer = $5, terms_accepted_at = CASE WHEN $6 THEN now() END, terms_version = CASE WHEN $6 THEN $7 END \
WHERE id = $1",
)
.bind(&session.id)
.bind(order)
.bind(&session.payment_intent)
.bind(amount_huf.map(|a| a as i32))
.bind(&session.customer_details)
.bind(session.terms_accepted())
.bind(TERMS_VERSION)
.execute(&mut *tx)
.await?;
confirm_by_email(&mut tx, state, session, user_id, package, amount_huf.unwrap_or(i64::from(price_huf))).await?;
let buyer = invoices::Buyer::from_stripe(session.customer_details.as_ref().unwrap_or(&Value::Null), None);
let (item, comment) = package.invoice_item();
let gross = amount_huf.unwrap_or(i64::from(price_huf));
@@ -215,6 +237,60 @@ async fn complete(state: &AppState, session: &stripe::Session) -> Result<bool, A
Ok(true)
}
/// The purchase confirmation (the "visszaigazolás" of the withdrawal waiver):
/// to the account's address, or Stripe's if the account is gone.
async fn confirm_by_email(
tx: &mut sqlx::PgConnection,
state: &AppState,
session: &stripe::Session,
user_id: Option<Uuid>,
package: &packages::Package,
amount_huf: i64,
) -> Result<(), ApiError> {
let account: Option<(String, String, Option<String>)> = match user_id {
Some(id) => {
sqlx::query_as("SELECT email, locale, display_name FROM users WHERE id = $1")
.bind(id)
.fetch_optional(&mut *tx)
.await?
}
None => None,
};
let stripe_email = session.customer_details.as_ref().and_then(|c| c["email"].as_str()).map(str::to_string);
let (to, locale, name) = match account {
Some((email, locale, name)) => (email, locale, name),
None => match stripe_email {
Some(email) => (email, "hu".to_string(), None),
None => return Ok(()),
},
};
let base = &state.config.public_base_url;
let payload = json!({
"url": format!("{base}/csomagok"),
"display_name": name,
"package_name": package.name,
"contents": package.contents_text(),
"amount": format_huf(amount_huf),
"paid_on": OffsetDateTime::now_utc().date().to_string(),
"terms_url": format!("{base}/aszf"),
"invoices_url": format!("{base}/szamlak"),
});
super::auth::queue_email_to(tx, user_id, &to, "purchase_confirmation", &locale, payload).await
}
/// "6 000 Ft"
fn format_huf(amount: i64) -> String {
let digits = amount.to_string();
let mut out = String::new();
for (i, c) in digits.chars().enumerate() {
if i > 0 && (digits.len() - i).is_multiple_of(3) {
out.push('\u{a0}');
}
out.push(c);
}
format!("{out}\u{a0}Ft")
}
/// Where a payment stands (the return page asks until it is paid). If the
/// webhook has not arrived yet, Stripe is asked directly.
pub async fn checkout_status(
+10
View File
@@ -36,6 +36,16 @@ pub struct Session {
/// Name, e-mail, billing address; for a company its name and tax ids.
#[serde(default)]
pub customer_details: Option<Value>,
/// `{"terms_of_service": "accepted"}` once the buyer ticked the terms box.
#[serde(default)]
pub consent: Option<Value>,
}
impl Session {
/// The buyer accepted the terms (and gave up the withdrawal right).
pub fn terms_accepted(&self) -> bool {
self.consent.as_ref().is_some_and(|c| c["terms_of_service"] == "accepted")
}
}
impl Session {
+30 -7
View File
@@ -2335,6 +2335,12 @@ async fn stripe_checkout_grants_the_paid_package_once(pool: PgPool) {
assert_eq!(stripe_form(&id, "customer_email").as_deref(), Some("anna@example.com"));
assert_eq!(stripe_form(&id, "tax_id_collection[enabled]").as_deref(), Some("true"));
assert_eq!(stripe_form(&id, "billing_address_collection").as_deref(), Some("required"));
// Every purchase accepts the terms and gives up the withdrawal right.
assert_eq!(stripe_form(&id, "consent_collection[terms_of_service]").as_deref(), Some("required"));
let consent = stripe_form(&id, "custom_text[terms_of_service_acceptance][message]").unwrap();
assert!(
consent.contains("[ÁSZF-et](https://sorsfonalak.test/aszf)") && consent.contains("14 napos elállási jogomat")
);
assert_eq!(
stripe_form(&id, "success_url").as_deref(),
Some("https://sorsfonalak.test/kepletek/abc?fizetes={CHECKOUT_SESSION_ID}")
@@ -2362,6 +2368,7 @@ async fn stripe_checkout_grants_the_paid_package_once(pool: PgPool) {
// and Stripe's retries do not grant it again.
let event = json!({"id": "evt_1", "type": "checkout.session.completed",
"data": {"object": {"id": id, "payment_status": "paid", "status": "complete",
"consent": {"terms_of_service": "accepted"},
"amount_total": 600000, "currency": "huf", "payment_intent": "pi_1",
"customer_details": {"name": "Kovács Anna", "email": "anna@example.com",
"business_name": "Csillag Kft.",
@@ -2384,13 +2391,29 @@ async fn stripe_checkout_grants_the_paid_package_once(pool: PgPool) {
}
assert_eq!(stripe_orders(&app.pool, "anna@example.com").await, vec![("couple".to_string(), 6000)]);
// What the invoice needs is kept, and the invoice is queued.
let (intent, amount, customer): (String, i32, Value) =
sqlx::query_as("SELECT payment_intent, amount_huf, customer FROM stripe_checkouts WHERE id = $1")
.bind(&id)
.fetch_one(&app.pool)
.await
.unwrap();
assert_eq!((intent.as_str(), amount), ("pi_1", 6000));
let (intent, amount, customer, terms): (String, i32, Value, Option<String>) = sqlx::query_as(
"SELECT payment_intent, amount_huf, customer, terms_version FROM stripe_checkouts \
WHERE id = $1 AND terms_accepted_at IS NOT NULL",
)
.bind(&id)
.fetch_one(&app.pool)
.await
.unwrap();
assert_eq!(
(intent.as_str(), amount, terms.as_deref()),
("pi_1", 6000, Some(crate::routes::payments::TERMS_VERSION))
);
// The confirmation e-mail (once, though the webhook came twice).
let mails: Vec<(Value,)> = sqlx::query_as(
"SELECT payload FROM email_outbox WHERE to_email = 'anna@example.com' AND template = 'purchase_confirmation'",
)
.fetch_all(&app.pool)
.await
.unwrap();
assert_eq!(mails.len(), 1);
assert_eq!((&mails[0].0["package_name"], &mails[0].0["amount"]), (&json!("Páros"), &json!("6\u{a0}000\u{a0}Ft")));
assert!(mails[0].0["contents"].as_str().unwrap().starts_with("2 részletes képletelemzés"));
email_templates::render("purchase_confirmation", "hu", &mails[0].0).unwrap();
assert_eq!(customer["tax_ids"][0]["value"], "12345678-1-23");
#[derive(sqlx::FromRow, Debug)]
struct Queued {