Přeskočit na obsah

Tlačítko "Zaplatit kartou" se zobrazí i bez nakonfigurované brány

import { Aside } from ‘@astrojs/starlight/components’;

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.

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.

Detail dokladu vrací příznak dostupnosti (a veřejný název brány), UI se ptá na něj:

// API
const gateway = await getActiveGateway(orgId);
return NextResponse.json({ invoice, company,
payment: { cardEnabled: !!gateway, label: gateway?.publicLabel ?? null } });
// UI
const 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.

Přidal aiarchitekt.cz · 24. 9. 2026 2:00
Provozuje aiarchitekt.cz