Aktualizujeme identifikátory mandátů tak, aby používaly delší formát identifikátoru API Mollie. Tato změna navazuje na předchozí aktualizaci identifikátorů API a sjednocuje mandáty se stejným standardem.
Co se mění?
Starší identifikátory mandátů obsahují 10 znaků za předponou mdt_. Nově vytvořené mandáty budou používat delší identifikátor, s až 22 znaky za předponou. Předpona mdt_ zůstává stejná.
Tato změna se vztahuje na nově vytvořené mandáty, včetně mandátů vytvořených automaticky prostřednictvím platby. Stávající mandáty si ponechávají své aktuální identifikátory a zůstávají použitelné. Kvůli této aktualizaci je nemusíte znovu vytvářet ani žádat zákazníky, aby je znovu autorizovali.
Co to pro vás znamená?
Pokud spravujete vlastní propojení, zkontrolujte všechny systémy, které ukládají, ověřují nebo předávají identifikátory mandátů - včetně platforem pro předplatné, fakturačního softwaru a dalších propojených systémů:
- Databázové úložiště: Pro úplný identifikátor včetně jeho předpony vyhraďte alespoň 40 znaků.
- Vlastní ověřování: Odstraňte kontroly, které vyžadují přesně 10 znaků za mdt_. Pokud ověřujete formát, kontrolujte očekávanou předponu, aniž byste pro zbytek vynucovali pevnou délku.
- Zpracování identifikátorů: Ukládejte a odesílejte úplný identifikátor přesně tak, jak jej vrací Mollie. Považujte jej za řetězec; nemusíte jej dekódovat ani interpretovat.
- Kompatibilita: Zajistěte, aby vaše propojení přijímalo stávající kratší i nové delší identifikátory.
Tato doporučení pro ukládání a ověřování vycházejí z našich stávajících pokynů k migraci identifikátorů. Můžete také nahlédnout do dokumentace k identifikátorům API.
Pokud používáte plugin nebo propojení spravované jiným poskytovatelem, ověřte si u tohoto poskytovatele, že podporuje delší identifikátory mandátů.
Změna identifikátorů však nemění způsob, jakým používáte mandáty pro opakované platby. Zkrácení nebo odmítnutí delšího identifikátoru však může vašemu propojení zabránit v načtení mandátu nebo jeho použití v žádosti o platbu. Pokud narazíte na problém, zkontrolujte, zda je úplný identifikátor zachován v celém vašem propojení, a kontaktujte podporu Mollie s příslušnou chybou API a identifikátorem mandátu.