V rámci úsilia spoločnosti Mollie zlepšiť spoľahlivosť a bezpečnosť našich systémov pracujeme na zjednotení našich API identifikátorov zdrojov podľa nového štandardu - identifikátory platieb a objednávok sú ďalší na rade.
Čo sa vyvíja?
Historicky, naše API identifikátory pozostávali z 10 znakov alebo menej (bez predpony, príklad: tr_XYZXYZXYZX). Od začiatku roka sme upgradovali tieto zastarané identifikátory na dlhší formát, pridávajúci ďalšie 4 až 12 znakov.
Novšie zdroje - ako Zachytávanie a Platobné odkazy - boli zavedené s týmto rozšíreným formátom od začiatku. Návraty, starší zdroj, boli nedávno aktualizované, aby prijali nový formát.
Ďalej sa táto zmena bude vzťahovať na naše najkritickejšie zdroje: Platby (Vytvoriť platbu -> Odpoveď -> ID) a Objednávky (Vytvoriť objednávku -> Odpoveď -> ID).
Čo to pre vás znamená?
Ak používate niektorú z našich predpripravených integrácií, ako WooCommerce, Shopify alebo Magento 2, nemali by ste touto zmenou zaznamenať žiadny vplyv. Skontrolovali sme tieto integrácie a neidentifikovali sme žiadne problémy s kompatibilitou.
Avšak, ak máte vlastnú integráciu s Mollie a/alebo ďalšie downstream integrácie, ktoré spracovávajú tieto platobné referencie (napríklad ERP, systémy riadenia objednávok alebo účtovné systémy), prosím, venujte chvíľu na preštudovanie nasledujúceho:
- Uloženie databázy: Ak tieto identifikátory ukladajúte, uistite sa, že dĺžka poľa nie je obmedzená len na 10 znakov. Odporúčame dĺžku poľa aspoň 40 znakov alebo viac, na zabezpečenie budúcnosti.
- Vlastná validácia: Uistite sa, že všetka vlastná validácia identifikátorov, ktorú máte, dokáže akceptovať dlhší formát. Odporúčame, že ak sa rozhodnete validovať formát tokenu, len skontrolujte, či predpona zodpovedá vašim očakávaniam a vyhnite sa validácii zvyšnej časti tokenu.
Táto aktualizácia by nemala narušiť spracovanie platieb, avšak nesprávne zaobchádzanie s novými identifikátormi by mohlo viesť k nezrovnalostiam. Ďalšie informácie o novom štandarde nájdete tu.
Pripravte sa na testovaciu transakciu:
Vykonáme jednu testovaciu transakciu na každú unikátnu kombináciu profilu/user_agent/client_id s použitím nových API identifikátorov dňa 5. júna, začínajúc o 2:00 SEČ. Preto smerujeme prvú transakciu tak, aby používala nový formát tokenu. Všetky nasledujúce transakcie budú znova používať starý štandard, až kým nezačneme roll-out 12. júna.
Ak sa po tomto teste vyskytnú akékoľvek problémy, dáme vám na výber dočasne sa odhlásiť od zmeny. Pošleme vám e-mailom formulár týkajúci sa odhlásenia dňa 6. júna.
Odstraňovanie problémov
Ako sa praxia vaše systémy nečakane stretávajú s problémami s manipuláciou s novým formátom tokenu, môžete spravovať transakciu (napr. zrušiť/vrátiť/zhvatať) ručne vo svojej Mollie Dashboard prechádzajúc na Objednávky/Platby, vyberajúc príslušnú transakciu a vykonávajúc požadovanú akciu tam.
Poznámka: Organizujeme Q&A stretnutie 2. júna na platforme Discord. Okrem toho môžete položiť akékoľvek otázky v tomto Discord kanáli.
Časové rámce:
- 2. júna: Q&A stretnutie - Pridajte sa k nám na Discorde
- 5. jún: Jedna testovacia transakcia na unikátnu kombináciu profilu/user-agent/client_id
- 6. jún: Nasledujúci e-mail s možnosťou dočasne sa odhlásiť od zmeny tokenu
- 12. jún: Začiatok postupného zavádzania nového formátu tokenu (okrem. odhlásení)
- 8. júl: 100% zavedenie nového formátu tokenu (okrem. odhlásení)
-
31. decembra: Koniec obdobia vyradenia, migrácia všetkých zostávajúcich profilov.