Návod na riešenie problémov s platobnou bránou
Čo sa deje, keď platby odmietajú ísť do cieľa
Zdá sa, že platobná brána je nečitateľná, ako keby sa zatúla v noci, no realita je jednoduchá – niečo v reťazci komunikácie porouchalo. Prvé ňušenie, keď sa transakcia spraví na vašom webe a zrazu sa vráti chybová správa. Tu sa začína horúca diskusia medzi vývojárom a tímom podpory.
Krok 1 – Získajte logy a nehovorte, že je to „nič veľké“
Vyhľadanie logov je ako nájsť špinavú ponožku v práčke – neodkladajte to. Skopírujte celé requesty, response kódy, timestampy, a všetko, čo si pamätá vaš server. Ak máte prístup k nástrojom ako Sentry alebo Loggly, hneď ich zapnite a nečakajte.
Krok 2 – Testujte API v izolácii
Zapojte Postman, rozprúďte si Curl a pošlite testovaciu objednávku. Krátka, dvojslovná inštrukcia: „Pošli 1 EUR“, a sledujte, či brána odpovedá 200 OK alebo 500 Internal Server Error. Ak odpovie 400, pravdepodobne vám v requeste chýba signačná hlavička. Zistite, či je token platný – mnohí poskytovatelia ho majú expirujúci po 60 minútach.
Prečo kontrolovať certifikáty?
Nezabudnite na TLS, pretože niektorí poskytovatelia už používajú TLS 1.3 a váš server je stále v 1.0. Rýchly fix: doplňte novú verziu do konfigurácie, a uvidíte rozdiel. Nebojte sa, že to spôsobí ďalšie problémy – väčšina moderných serverov je kompatibilná.
Krok 3 – Kontaktujte poskytovateľa
Ak ste na konci tunela a nič nezabudnete, urobte jedno rozhodnutie: napíšte ich supportu. V správe zahrňte screenshoty, čísla requestov a presný čas. Nepísajte „mám problém“, ale „Naša integrácia vrátila chybu 502 pri volaní endpointu /transaction». Základ je v konkrétnosti, nie v abstraktnom plašení.
Rýchla fixácia – presmerovanie na inú bránu
Keď už ste v kríze, prepnite dočasne všetky platby na alternatívny poskytovateľ, napríklad Stripe či PayU, a vylepšite monitorovanie. Týmto spôsobom nezastavíte cashflow a získate čas na detailnú analýzu. Môžete tiež nastaviť fallback do kódu: ak prvý endpoint zlyhá, automaticky pošle request na náhradný.
Na konci dňa, ak chcete, aby systém fungoval bez výpadkov, nastavte alarmy v Grafane, aby ste sa dozvedeli o probléme skôr, než zákazník zistí, že platba neprešla. A keďže všetko musíte mať pod kontrolou, prečítajte si detailný popis na tatrapaystavky.com. Vyskúšajte rýchlu kontrolu certifikátov, a ak sa vám nepodarí, okamžite reštartujte službu.
Jedna veta na koniec: aktualizujte API kľúče každých 30 dní a všetko ide hladko.
