diff --git a/docs/fizetes.md b/docs/fizetes.md index 7459fe2..11956c0 100644 --- a/docs/fizetes.md +++ b/docs/fizetes.md @@ -34,7 +34,7 @@ A sorok a fiók törlése után is megmaradnak (`user_id` → NULL), mert a szá ## Számla -Fizetéskor a backend egy `invoices` sort is létrehoz a számla minden adatával: a vevő (név, e-mail, ország, irányítószám, város, cím, Billingo-adótípus: `HAS_TAX_NUMBER` / `NO_TAX_NUMBER` / `FOREIGN`, adószám) és a tétel (név, végösszeg, nettó, áfa, áfakód). Az áfakód az `INVOICE_VAT` (a backend `.env`-je): alapból `AAM` (alanyi adómentes: nettó = végösszeg, áfa 0, a számla megjegyzésében „Alanyi adómentes.”), vagy egy kulcs, pl. `27%`. A tétel a törvény szerint azonosítja a szolgáltatást (Áfa tv. 169. § e): megnevezése pl. „Online tartalomszolgáltatás – Páros csomag”, egysége `csomag`, megjegyzése a tartalom („Hozzáférés a sorsfonalak.hu szoftveresen előállított, személyre szabott szöveges tartalmaihoz: 2 képletelemzés, … Digitális tartalom.”; `Package::invoice_item`). Szándékosan nem „asztrológiai”: a szolgáltatás egy weboldal programmal előállított tartalma, nem személyes szakmai tanácsadás. Cégnél a `business_name` és a magyar adószám (`hu_tin`, ennek híján `eu_vat`) kerül a számlára. +Fizetéskor a backend egy `invoices` sort is létrehoz a számla minden adatával: a vevő (név, e-mail, ország, irányítószám, város, cím, Billingo-adótípus: `HAS_TAX_NUMBER` / `NO_TAX_NUMBER` / `FOREIGN`, adószám) és a tétel (név, végösszeg, nettó, áfa, áfakód). Az áfakód az `INVOICE_VAT` (a backend `.env`-je): alapból `AAM` (alanyi adómentes: nettó = végösszeg, áfa 0, a számla megjegyzésében „Alanyi adómentes.”), vagy egy kulcs, pl. `27%`. A tétel a törvény szerint azonosítja a szolgáltatást (Áfa tv. 169. § e): megnevezése a fő csomagoknál pl. „Online tartalomszolgáltatás – Páros csomag”, a kiegészítőknél egységesen „Online tartalomszolgáltatás – kiegészítő csomag”, egysége `csomag`, megjegyzése a tartalom („Hozzáférés a sorsfonalak.hu szoftveresen előállított, személyre szabott szöveges tartalmaihoz: 2 képletelemzés, … Digitális tartalom.”; `Package::invoice_item`). Szándékosan semleges: nem „asztrológiai”, és nem „jóslás” vagy „kártya” (a kártyajóslás a megjegyzésben „egyedi szöveges tartalom”), mert a szolgáltatás egy weboldal programmal előállított tartalma, nem személyes szakmai tanácsadás. A Stripe fizetési oldalán és nyugtáján a csomag neve és leírása áll, ott a „kártyajóslás” helyett „kártya” (`Package::checkout_text`). A Telegram-értesítő a kiegészítőknél a csomag azonosítóját is kiírja („kiegészítő csomag (addon_tarot)”). Cégnél a `business_name` és a magyar adószám (`hu_tin`, ennek híján `eu_vat`) kerül a számlára. Minden igazolt fizetéshez készül számla, a teszt módúakhoz (`sk_test_…`) is: így a teljes folyamat próbálható egy teszt Billingo-fiókkal. Éles Billingo-fiók mellett ezért prodon már ne legyen teszt Stripe-kulcs (a kettőt megnyitáskor együtt kell élesre cserélni). diff --git a/docs/kartyajoslas.md b/docs/kartyajoslas.md index 572365a..cfca3c1 100644 --- a/docs/kartyajoslas.md +++ b/docs/kartyajoslas.md @@ -14,4 +14,4 @@ A `/kartyajoslas` oldalon a felhasználó témát (Általános, Párkapcsolat, M ## Csomagok -Egy elemzés: 2, Páros: 5, Család: 10 jóslás; külön: „+5 kártyajóslás” 1 000 Ft. A számlán a tétel leírásában „kártyaértelmezés” szerepel (nem „jóslás”). +Egy elemzés: 2, Páros: 5, Család: 10 jóslás; külön: „+5 kártyajóslás” 1 000 Ft. A számlán a kiegészítő neve „Online tartalomszolgáltatás – kiegészítő csomag”, a tétel leírásában „egyedi szöveges tartalom” szerepel (sem „jóslás”, sem „kártya”). A Stripe fizetési oldalán „+5 kártya”. diff --git a/services/backend/src/packages.rs b/services/backend/src/packages.rs index 8c6a13d..1a47aed 100644 --- a/services/backend/src/packages.rs +++ b/services/backend/src/packages.rs @@ -245,11 +245,13 @@ impl Package { /// 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). + /// contains (Áfa tv. 169. § e). Kept neutral: the main packages keep + /// their plain names, the add-ons share one name, and tarot readings are + /// listed as text content. pub fn invoice_item(&self) -> (String, String) { let name = match self.tier { Tier::Main => format!("Online tartalomszolgáltatás – {} csomag", self.name), - Tier::Addon => format!("Online tartalomszolgáltatás – {} kiegészítő", self.name), + Tier::Addon => "Online tartalomszolgáltatás – kiegészítő csomag".to_string(), }; let lines: Vec = [ (self.natal, "képletelemzés"), @@ -257,7 +259,7 @@ impl Package { (self.forecast, "éves előrejelzés"), (self.persons, "további személy felvétele"), (self.questions, "kérdés"), - (self.tarot, "kártyaértelmezés"), + (self.tarot, "egyedi szöveges tartalom"), ] .into_iter() .filter(|&(n, _)| n > 0) @@ -271,6 +273,13 @@ impl Package { (name, comment) } + /// The name and description on Stripe's payment page and receipt: as on + /// the site, but tarot readings are called "kártya" there. + pub fn checkout_text(&self) -> (String, String) { + let plain = |s: &str| s.replace("kártyajóslás", "kártya"); + (format!("Sorsfonalak – {}", plain(self.name)), plain(self.tagline)) + } + /// What the package gives, unit by unit. pub fn contents(&self) -> [(Unit, i64); 6] { [ @@ -420,12 +429,24 @@ mod tests { comment, "Hozzáférés a sorsfonalak.hu szoftveresen előállított, személyre szabott szöveges tartalmaihoz: \ 2 képletelemzés, 1 kapcsolati elemzés, 2 éves előrejelzés, 1 további személy felvétele, 3 kérdés, \ - 5 kártyaértelmezés. Digitális tartalom." + 5 egyedi szöveges tartalom. Digitális tartalom." ); let (name, comment) = find("addon_persons").unwrap().invoice_item(); - assert_eq!(name, "Online tartalomszolgáltatás – +5 személy kiegészítő"); + assert_eq!(name, "Online tartalomszolgáltatás – kiegészítő csomag"); assert!(comment.ends_with("tartalmaihoz: 5 további személy felvétele. Digitális tartalom."), "{comment}"); - // No profession is implied. - assert!(CATALOG.iter().all(|p| !format!("{:?}", p.invoice_item()).to_lowercase().contains("asztrol"))); + // No profession and no fortune-telling is implied. + for package in &CATALOG { + let item = format!("{:?}", package.invoice_item()).to_lowercase(); + assert!(!item.contains("asztrol") && !item.contains("jóslás") && !item.contains("kártya"), "{item}"); + } + } + + #[test] + fn stripe_says_kartya_instead_of_kartyajoslas() { + let (name, description) = find("addon_tarot").unwrap().checkout_text(); + assert_eq!(name, "Sorsfonalak – +5 kártya"); + assert_eq!(description, "Öt újabb kártya a saját kérdéseidre."); + assert_eq!(find("couple").unwrap().checkout_text().0, "Sorsfonalak – Páros"); + assert!(CATALOG.iter().all(|p| !format!("{:?}", p.checkout_text()).contains("jóslás"))); } } diff --git a/services/backend/src/routes/payments.rs b/services/backend/src/routes/payments.rs index f7845ca..8cddc3e 100644 --- a/services/backend/src/routes/payments.rs +++ b/services/backend/src/routes/payments.rs @@ -132,6 +132,7 @@ pub async fn checkout( let config = stripe_for(&state, &auth)?; let package = packages::find(&req.package).ok_or(ApiError::NotFound("package"))?; let back = format!("{}{}", state.config.public_base_url, return_path(req.return_path.as_deref())); + let (checkout_name, checkout_description) = package.checkout_text(); let field = |k: &str, v: &str| (k.to_string(), v.to_string()); let mut form = vec![ field("mode", "payment"), @@ -147,11 +148,11 @@ pub async fn checkout( field("line_items[0][price_data][currency]", "huf"), // Stripe counts forints in fillér. field("line_items[0][price_data][unit_amount]", &(package.price_huf * 100).to_string()), - field("line_items[0][price_data][product_data][name]", &format!("Sorsfonalak – {}", package.name)), - field("line_items[0][price_data][product_data][description]", package.tagline), + field("line_items[0][price_data][product_data][name]", &checkout_name), + field("line_items[0][price_data][product_data][description]", &checkout_description), field("metadata[package]", package.id), field("metadata[user_id]", &auth.id().to_string()), - field("payment_intent_data[description]", &format!("Sorsfonalak – {}", package.name)), + field("payment_intent_data[description]", &checkout_name), field("payment_intent_data[metadata][package]", package.id), field("success_url", &format!("{back}?fizetes={{CHECKOUT_SESSION_ID}}")), field("cancel_url", &format!("{back}?fizetes=megszakitva")), diff --git a/services/worker/src/notify.rs b/services/worker/src/notify.rs index 5d826f4..20a2643 100644 --- a/services/worker/src/notify.rs +++ b/services/worker/src/notify.rs @@ -17,17 +17,20 @@ use crate::telegram::{Telegram, huf}; const BATCH: i64 = 20; /// The notice of one purchase. -fn text(item: &str, price_huf: i32, live: bool) -> String { +fn text(item: &str, package: &str, price_huf: i32, live: bool) -> String { // The invoice item without its service prefix ("Online tartalomszolgáltatás – "). let item = item.rsplit(" – ").next().unwrap_or(item); - format!("🛒 Vásárlás: {item}, {}{}", huf(price_huf), if live { "" } else { " (teszt fizetés)" }) + // The add-ons share one neutral invoice name; their id tells them apart. + let what = + if package.starts_with("addon_") && item != package { format!("{item} ({package})") } else { item.into() }; + format!("🛒 Vásárlás: {what}, {}{}", huf(price_huf), if live { "" } else { " (teszt fizetés)" }) } /// Sends the notices of the purchases not notified yet; returns how many went out. pub async fn run_once(db: &PgPool, telegram: &Telegram) -> Result { let mut tx = db.begin().await?; - let due: Vec<(String, String, i32, bool)> = sqlx::query_as( - "SELECT c.id, coalesce(i.item_name, c.package), coalesce(c.amount_huf, c.price_huf), c.live \ + let due: Vec<(String, String, String, i32, bool)> = sqlx::query_as( + "SELECT c.id, coalesce(i.item_name, c.package), c.package, coalesce(c.amount_huf, c.price_huf), c.live \ FROM stripe_checkouts c LEFT JOIN invoices i ON i.checkout_id = c.id \ WHERE c.completed_at IS NOT NULL AND c.notified_at IS NULL \ ORDER BY c.completed_at LIMIT $1 FOR UPDATE OF c SKIP LOCKED", @@ -36,8 +39,8 @@ pub async fn run_once(db: &PgPool, telegram: &Telegram) -> Result sent += 1, Err(e) if e.permanent => { tracing::error!(checkout = %id, error = %e.message, "telegram refused the purchase notice; check TELEGRAM_*"); @@ -122,11 +125,17 @@ mod tests { #[test] fn notice_texts() { assert_eq!( - text("Online tartalomszolgáltatás – Páros csomag", 6000, true), + text("Online tartalomszolgáltatás – Páros csomag", "couple", 6000, true), "🛒 Vásárlás: Páros csomag, 6\u{a0}000\u{a0}Ft" ); + // The add-ons share one invoice name: the id says which one it was. assert_eq!( - text("addon_questions", 1000, false), + text("Online tartalomszolgáltatás – kiegészítő csomag", "addon_tarot", 1000, true), + "🛒 Vásárlás: kiegészítő csomag (addon_tarot), 1\u{a0}000\u{a0}Ft" + ); + // No invoice yet: the id alone. + assert_eq!( + text("addon_questions", "addon_questions", 1000, false), "🛒 Vásárlás: addon_questions, 1\u{a0}000\u{a0}Ft (teszt fizetés)" ); }