A Mollie megbízhatóságának és biztonságának javítása érdekében dolgozunk azon, hogy az API erőforrás-azonosítók egységesített új standard alatt egyesüljenek - a következő a fizetési és rendelési azonosítók.
Mi változik?
Történelmileg az API azonosítók 10 karakterből vagy kevesebből álltak (a prefixet nem számítva, például: tr_XYZXYZXYZX). Az év eleje óta frissítjük ezeket az elavult azonosítókat egy hosszabb formátumra, amely 4-12 karakterrel bővül.
Az újabb erőforrások - mint például a Felvételek és a Fizetési Linkek - ezt a bővített formátumot használták a kezdetektől fogva. A visszatérítések, mint régebbi források, mostanában frissítették a formátumot.
Ez a változás következőként a legkritikusabb erőforrásainkra lesz érvényes: Fizetések (Fizetés létrehozása -> Válasz -> Azonosító) és Megrendelések (Megrendelés létrehozása -> Válasz -> Azonosító).
Mit jelent ez önnek?
Ha valamelyik előre elkészített integrációnkat használod, például WooCommerce-t, Shopify-t vagy a Magento 2-t, akkor nem kell hatást tapasztalnod emiatt a változás miatt. Átvizsgáltuk ezeket az integrációkat, és nem találtunk kompatibilitási problémát.
Ha azonban van egy egyedi fejlesztésű integrációja a Mollie-val és/vagy további alsóbb rétegekkel integrációk, amelyek kezelik ezeket a fizetési hivatkozásokat (például ERP, rendeléskezelő vagy könyvelési rendszerek), kérjük, szánjon rá egy pillanatot a következő átnézésére:
- Adatbázis tárolás: Ha ezeket az azonosítókat tárolja, győződjön meg róla, hogy a mező hossza nem korlátozott 10 karakterre. Legalább 40 vagy annál több karakter hosszú mezőt javaslunk a jövőbeni megbízhatóság érdekében.
- Testreszabott érvényesítés: Győződjön meg róla, hogy bármilyen egyedi azonosító érvényesítése, amelyet alkalmaz, képes kezelni a hosszabb formátumot. Azt javasoljuk, hogy ha úgy dönt, hogy ellenőrzi a token formátumot, csak azt ellenőrizze, hogy a prefix megváltozik az elvárásaival, és kerülje el a token maradékának érvényesítését.
Ez a frissítés nem zavarja meg a fizetési feldolgozást, azonban az új azonosítók helytelen kezelése eltérésekhez vezethet. További információt az új szabványról itt találhatsz.
Készüljön fel egy teszt tranzakcióra:
Egy teszt tranzakciót fogunk végrehajtani minden egyedi profil/user_agent/client_id kombinációval az új API azonosítók használatával június 5-én, kezdve 2 órakor CET. Ezért az első tranzakciót az új token formátumának használatához irányítjuk. Minden további tranzakció ismét a régi szabványt fogja használni, amíg el nem kezdjük a bevezetést június 12-én.
Ha a teszt után bármilyen probléma merül fel, lehetőséget adunk arra, hogy ideiglenesen lemondjon a változásról. A június 6-án kap egy e-mailt a lemondási űrlapról.
Hibaelhárítás
Ha a rendszerei váratlanul problémákat tapasztalnak az új token formátum kezelésében, kezelheti a tranzakciót (például törlés/visszatérítés/felvétel) kézzel az Mollie Irányítópulton a Rendelések/Fizetések menüpont alatt a megfelelő tranzakció kiválasztásával és a kívánt művelet végrehajtásával.
Megjegyzés: Q&A szekciót tartunk június 2-án a Discordon. Továbbá, feltehetsz minden kérdést ebben a csatornában a Discordon.
Idővonalak:
- Június 2.: Q&A szekció - Csatlakozz hozzánk a Discordon
- Június 5.: Egyszeri teszt tranzakció minden egyedi profil/user-agent/client_id kombinációhoz
- Június 6.: Követő e-mail, lehetőséggel az új token változásának ideiglenes lemondására
- Június 12.: A fokozatos bevezetés kezdete
- Július 8.: 100%-os bevezetés az új token formátumra (kivéve a lemondásokat)
-
December 31.: Az elutasítási időszak vége, minden fennmaradó profil migrálása.