Tlačítko "Zaplatit kartou" se zobrazí i bez nakonfigurované brány
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Veřejný odkaz na fakturu (klientský portál) nabízel u každé neuhrazené faktury tlačítko „Zaplatit kartou” — i u tenantů, kteří žádnou platební bránu nemají nastavenou. Koncový zákazník klikl a dostal chybovou hlášku. Provozovatel platformy navíc oprávněně podezříval, že platba míří na jeho účet.
Root cause
Sekce “Root cause”Podmínka pro vykreslení tlačítka se ptala jen na stav dokladu:
const canPay = !["PAID", "CANCELED", "DRAFT"].includes(invoice.status);Znalost „tenant má/nemá bránu” žila jen na serveru, v platebním endpointu,
který teprve po kliknutí vrátil 410 no_gateway_configured. Detail dokladu,
ze kterého se stránka renderuje, ji vůbec neposílal.
Routing peněz byl přitom v pořádku — endpoint četl výhradně credentials daného
tenanta a nikdy nepadal zpátky na platformní *_MERCHANT/*_SECRET z env.
To je ta podstatná část: dostupnost metody a cíl peněz jsou dvě různé otázky
a obě je potřeba umět zodpovědět před vykreslením tlačítka.
Fix
Sekce “Fix”Detail dokladu vrací příznak dostupnosti (a veřejný název brány), UI se ptá na něj:
// APIconst gateway = await getActiveGateway(orgId);return NextResponse.json({ invoice, company, payment: { cardEnabled: !!gateway, label: gateway?.publicLabel ?? null } });
// UIconst isOpen = !["PAID", "CANCELED", "DRAFT"].includes(invoice.status);const canPay = isOpen && data.payment?.cardEnabled === true;Důležité: bankovní údaje a QR kód zůstaly navázané na isOpen, ne na canPay —
tenanti bez brány nesmí přijít i o převod. Selhání čtení konfigurace brány se
loguje a degraduje na cardEnabled: false, nikdy neshodí zobrazení faktury.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: najdi každý platební CTA a zpětně dohledej, z jaké hodnoty se renderuje. Když mezi podmínkou a credentials není žádná vazba, je to tenhle bug. Test: doklad tenanta bez brány → CTA se nesmí objevit.
- Anti-pattern: endpoint vrací
410 / "brána není nakonfigurovaná"jako běžnou odpověď. To je signál, že UI nabízí něco, co backend nemůže splnit. - Lepší přístup: dostupnost platební metody je součástí read modelu dokladu. Zároveň ověř, že provider nemá env fallback na platformní credentials — v multi-tenantu by platba skončila na účtu provozovatele.
Sister bugs / související
Sekce “Sister bugs / související”Stejná třída: webhook platební brány ověřovaný platformním secretem, zatímco platba vznikla pod credentials tenanta — notifikace neprojde podpisem a doklad zůstane neuhrazený. Jakmile se povolí brány per tenant, musí se per tenant řešit i ověření callbacku.