PSD2 lofaði einu API fyrir alla banka í Evrópu. Það sem við fengum er ein staðlafjölskylda og nokkur hundruð túlkanir á henni. Eftir fimm ár af því að byggja og reka tengingar fyrir reikningsupplýsingar og greiðsluútgáfu fyrir viðskiptavini um öll Eystrasaltsríkin er mynstrið skýrt: fyrsti bankinn tekur viku, fimmti tekur einn dag, og svo tekur sá næsti óvænt heilan mánuð.
Samþykkisferlið er þar sem verkefni stranda
API-köllin eru auðveldi hlutinn. Erfiði hlutinn er lífsferill samþykkisins - hvernig viðskiptavinur veitir aðgangi þínum heimild, hversu lengi sú heimild lifir, og hvað gerist þegar hún rennur út klukkan 03:00 á sunnudegi.
- Sumir bankar gefa út 90 daga samþykki og endurnýja hljóðlega; aðrir krefjast fullrar endurauðkenningar.
- Samþykkisferli í prófunarumhverfi (sandbox) eru reglulega frábrugðin þeim sem eru í raunumhverfi. Gerðu ráð fyrir annarri samþættingarlotu eftir gangsetningu.
- Villuflokkun er ósamkvæm: sama útrunna samþykkið getur birst sem
401,403, eða - í einu eftirminnilegu tilviki -200með tómum færslulista.
Það síðastnefnda á skilið áherslu: tómt svar er ekki það sama og árangursríkt svar. Ef afstemmingin þín byggir á færslustreymi skaltu meðhöndla „engar færslur" sem ástand til að staðfesta, ekki staðreynd til að skrá.
Það sem við stöðlum
Sérhver tenging sem við afhendum keyrir núna á bak við sama innra viðmótið, með bankasértækum millistykkjum sem eru vísvitandi höfð einföld. Sama agi gildir á greiðsluútgáfuhliðinni - einn staðlaður greiðsluhlutur, kortlagður skýrt yfir í mállýsku hvers banka:
Millistykkið sér um sérkenni í auðkenningu og ólíkar aðferðir hvers banka við að sækja gögn síðu fyrir síðu; allt annað - endurtekningar, idempotency, viðvaranir, viðvaranir um að samþykki sé að renna út - er í sameiginlega laginu, skrifað einu sinni og prófað einu sinni.
Ef bankasamþætting þarf sérsniðna endurtekningarrökfræði á sú rökfræði heima í sameiginlega laginu með eiginleikaflaggi - aldrei í millistykkinu. Millistykki sem látin eru afskiptalaus úreldast; sameiginlega laginu er hins vegar stöðugt viðhaldið.
Niðurstaðan verður fyrirsjáanleg rútína - og það er einmitt markmiðið. Nýr banki er nýtt millistykki, prófunarskrá tekin upp úr prófunarumhverfi hans, og gátlisti - ekki nýtt verkefni.