Uuenda API identifikaatoreid

Mollie püüdluste osana meie süsteemide usaldusväärsuse ja turvalisuse parandamiseks töötame selle nimel, et ühtlustada meie API ressursi identifikaatorid uue standardi alusel - järgmised on makse- ja tellimuse identifikaatorid. 

 

Mis on muutumas?

Ajalooliselt koosnesid meie API identifikaatorid 10 märkist või vähem (ilma eesliiteta, näiteks: tr_XYZXYZXYZX). Aasta algusest oleme neid vanu identifikaatoreid uuendamas pikema formaadi, lisades 4 kuni 12 lisa märki.

Uued ressursid - nagu Captures ja Payment Links - kasutati algusest peale käesolevat pikendatud formaati. Tagasimaksed, vanem ressurss, uuendati hiljuti, et võtta üle uus formaat.

Järgmisena rakendub see muudatus meie kõige olulisematele ressurssidele: Maksed (Loo makse -> Vastus -> ID) ja Tellimused (Loo tellimus -> Vastus -> ID). 

 

Mida see sinu jaoks tähendab?

Kui kasutad mõnda meie valmis intergratsiooni, nagu WooCommerce, Shopify või Magento 2, siis see muudatus sinu jaoks mõju ei avalda. Oleme need integratsioonid üle vaadanud ja ei ole tuvastanud ühtki ühilduvuse probleemi. 

Kuid kui sul on kohandatud integreerimine Mollie ja/või täiendavad allavooluse integreerimised, mis käsitlevad neid makseviiteid (näiteks ERP, tellimuse haldamine või raamatupidamissüsteemid), palun võta hetk, et tutvuda järgmisega:

  • Andmete salvestamine: Kui sa salvestad neid identifikaatoreid, kontrolli, et välja pikkus pole piiratud vaid 10 märgiga. Soovitame välja pikkuseks vähemalt 40 märki või rohkem tuleviku kindlustamiseks.
  • Kohandatud valideerimine: Veendu, et iga kohandatud identifikaatori valideerimine suudab mahutada pikemat formaati. Soovitame, et kui otsustad valideerida tokeni formaati, kontrolli ainult, et eesliide vastab sinu ootustele ja väldi tokeni ülejäänud osa valideerimist.

See uuendus ei tohiks maksete töötlemist häirida, kuid uute identifikaatorite vale käsitlemine võib põhjustada vastuvõetamatuse. Lisainfo uue standardi kohta leiad siit.

 

Valmista ette testtransaktsioon:

Teeme iga unikaalse profiili/user_agent/client_id kombinatsiooni kohta ühe testtransaktsiooni, kasutades uusi API identifikaatoreid 5. juunil, alates kell 2 CET. Seetõttu suunatakse esimene tehing, mis tehakse, kasutama uut tokeni formaati. Kõik järgnevad tehingud kasutavad vana standardit uuesti, kuni alustame juurutamist 12. juunil.
Kui pärast seda testi tekivad mured, anname sulle võimaluse ajutiselt loobuda muudatusest. Saadame sulle 6. juunil teabe loobumise kohta. 

Probleemide lahendamine
Kui sinu süsteemid ootamatult ei suuda uut tokeni formaati käsitleda, saad tehingu (nt tühistamine/tagasimakse/kinnihoidmine) käsitsi hallata oma Mollie töölaud, navigeerides Tellimuste/Maksete juurde, valides asjakohase tehingu ja sooritades seal soovitud tegevuse. 

 

Märkus: Korraldame K&K sessiooni 2. juunil Discordis aadressil Discord. Lisaks saad esitada kõik küsimused selles kanalis Discordis

Ajakavad:

  • 2. juuni: K&K sessioon - Liitu meiega Discordis
  • 5. juuni: Üksik testtransaktsioon iga unikaalse profiili/user-agent/client_id kombinatsiooni kohta
  • 6. juuni: Jätkava e-kirja saatmine, koos võimalusega ajutiselt loobuda uue tokeni muudatusest
  • 12. juuni: Uue tokeni formaadi järkjärguline juurutamine (ilma loobumisteta) 
  • 8. juuli: 100% juurutamine uue tokeni formaadi (ilma loobumisteta)
  • 31. detsember: Väljaastumise perioodi lõpp, kõigi ülejäänud profiilide migreerimine.