Jako součást snah společnosti Mollie o zlepšení spolehlivosti a bezpečnosti našich systémů pracujeme na sjednocení našich identifikátorů API zdrojů podle nového standardu - identifikátory plateb a objednávek jsou na řadě.
Co se mění?
Historicky naše identifikátory API consist 10 znaků nebo méně (bez předpony, příklad: tr_XYZXYZXYZX). Od začátku roku modernizujeme tyto zastaralé identifikátory na delší formát přidáním dalších 4 až 12 znaků.
Novější zdroje - jako jsou Záznamy a Odkazy na platby - byly od začátku zavedeny pomocí tohoto rozšířeného formátu. Vrátky, starší zdroj, byly nedávno aktualizovány, aby přijaly nový formát.
Dále se tato změna bude týkat našich nejdůležitějších zdrojů: Platby (Vytvořit platbu -> Odpověď -> ID) a Objednávky (Vytvořit objednávku -> Odpověď -> ID).
Co to pro vás znamená?
Pokud používáte některé z našich připravených propojení, například WooCommerce, Shopify nebo Magento 2, tato změna by na vás neměla mít žádný dopad. Tyto integrace jsme zkontrolovali a neidentifikovali jsme žádné problémy s kompatibilitou.
Pokud máte však vlastní integrované řešení se systémem Mollie a/nebo další integrování řešení, která zpracovávají tyto platební reference (například ERP, systémy pro správu objednávek nebo účetní systémy), věnujte chvíli níže uvedeným informacím:
- Uložení do databáze: Pokud tyto identifikátory ukládáte, ujistěte se, že délka pole není omezena pouze na 10 znaků. Doporučujeme délku pole alespoň 40 znaků nebo více pro zajištění budoucnosti.
- Vlastní validace: Ujistěte se, že jakákoli vlastní validace identifikátorů, kterou máte, může vyhovět delšímu formátu. Doporučujeme, abyste, pokud se rozhodnete validovat formát tokenu, kontrolovali pouze to, zda předpona odpovídá vašim očekáváním, a vyhnuli se validaci zbytku tokenu.
Tato aktualizace by neměla narušovat zpracování plateb, avšak nesprávné zpracování nových identifikátorů může vést k nesrovnalostem. Další informace o novém standardu najdete zde.
Připravte se na testovací transakci:
Provedeme jednu testovací transakci na každé unikátní kombinaci profilu/uživatel_agent/client_id pomocí nových identifikátorů API dne 5. června, počínaje 2 hodinou ráno CET. Proto směrujeme první provedenou transakci, aby využila nový formát tokenu. Všechny následující transakce budou opět používat starý standard, dokud nezačneme rozšíření 12. června.
Pokud po tomto testu nastanou nějaké problémy, dáme vám na výběr dočasně se od této změny odhlásit. Pošleme vám formulář ohledně odhlášení dne 6. června.
Řešení problémů
Pokud vaše systémy neočekávaně mají problémy se zpracováním nového formátu tokenu, můžete spravovat transakci (např. zrušit/vrátit/uchopit) ručně ve vašem Mollie Dashboard tím, že se přepnete na Objednávky/Platby, vyberete příslušnou transakci a tam provedete požadovanou akci.
Poznámka: Pořádáme Q&A setkání 2. června které proběhne na Discordu. Navíc můžete položit jakékoli dotazy v tomto kanálu Discord.
Časové osy:
- 2. června: Q&A setkání - Připojte se k nám na Discordu
- 5. června: Jediná testovací transakce na unikátní kombinaci profilu/uživatel_agents/ID klienta
- 6. června: Následný e-mail s možností dočasně se odhlásit ze změny tokenu
- 12. června: Začátek postupného rozšíření nového formátu tokenu (včetně odhlášení)
- 8. července: 100% rozšíření nového formátu tokenu (včetně odhlášení)
-
31. prosince: Konec období pro odhlášení, migrace všech zbývajících profilů.