Mokėjimų branduolys

Mokėjimų logika vis būdavo perrašoma kiekvienam produktui ir susipindavo su to produkto karkasu bei duomenų baze — kaip tik ten ir slepiasi mokėjimų klaidos.

Naršyklės peradresavimas iš banko reiškia tik tai, kad vartotojas grįžo į svetainę — jis nereiškia, kad pinigai pajudėjo, tačiau daugybė integracijų pažymi užsakymą apmokėtu būtent pagal šį signalą. Šis branduolys sukurtas remiantis priešinga prielaida: peradresavimas nieko neįrodo, o vienintelė patikima būsena ateina iš pasirašyto atgalinio iškvietimo arba serverinio būsenos patikrinimo. Visą laiką įtampą kėlė tai, kad kiekvienas bankų nuorodų protokolas, kortelių agregatorius ir piniginės API pasirašo, koduoja ir praneša sumas skirtingai, todėl sutvirtinimas turėjo būti bendra logika, o ne kopijavimas kiekvienam teikėjui atskirai.

Grynas TypeScript branduolys su mokėjimų srities taisyklėmis be jokių framework ar DB importų; kiekvienas Lietuvos bankas ar PSP yra plonas provaiderio adapteris, o branduolys sustiprintas ten, kur pinigai realiai lūžta: webhook parašo ir šviežumo tikrinimai, apsaugos nuo sumos perpildymo ir per daug skaitmenų, patikrinti nukreipimo taikiniai ir rankinės peržiūros srautai, kai callback nuoroda ar suma nesutampa.

Tai TypeScript paketas, apimantis tik mokėjimų srities taisykles — užklausų pasirašymą, atgalinių iškvietimų validavimą, būsenų normalizavimą, sumos ir valiutos patikras, pasikartojančių iškvietimų tvarkymą ir audito požiūriu saugius normalizuotus įvykius. Branduolys neimportuoja jokio karkaso, HTTP vykdymo aplinkos ar duomenų bazės kliento: jis priima paprastą PaymentHttpRequest struktūrą, todėl tas pats teikėjų kodas veikia iš mūsų reaktyvaus serverio, Node darbininkų ar testų. Įgyvendinti keli realūs Lietuvos bankų ir PSP teikėjai; bankai be oficialios komercinės medžiagos tiekiami kaip griežti karkasai, kurie meta klaidą, o ne spėja.

Sukurta su TypeScript, Bank integrations, Crypto.

Grynas TypeScript su prijungiamais Web Crypto ir Node crypto adapteriais, jokio karkaso importų branduolio įėjimo taške ir CI vartai, laikantys 100% sakinių, šakų, funkcijų ir eilučių padengimą vykdymo kode.

Naujas produktas prijungia mokėjimus rašydamas adapterius aplink vieną ištestuotą, saugumo patikromis apsaugotą branduolį, o ne iš naujo įgyvendindamas bankų srautus ir klaidų būsenas.

Tas pats teikėjų kodas veikia nepakeistas skirtinguose serveriuose ir testuose, o kiekvienas pinigus užbaigiantis kelias lūžta saugiai — perpildyta suma, pakartotas iškvietimas ar nesutampanti nuoroda parodo jokio mokėjimo arba peržiūros žymą, o ne neteisingą.