Aktualizujeme identifikátory mandátů, zákazníků a předplatných tak, aby používaly delší formát identifikátorů API Mollie. Tato změna navazuje na předchozí aktualizaci identifikátorů API a uvádí mandáty, zákazníky a předplatná do souladu se stejným standardem.
Co se mění?
Starší identifikátory mandátů obsahují 10 znaků za předponou mdt_. Starší identifikátory zákazníků obsahují 10 znaků za předponou cst_. Starší identifikátory předplatných obsahují 10 znaků za předponou sub_. Nově vytvořené mandáty, zákazníci a předplatná budou používat delší identifikátor s až 22 znaky za příslušnou předponou. Samotné předpony zůstávají stejné.
Tato změna se vztahuje na nově vytvořené mandáty, zákazníky a předplatná, včetně mandátů automaticky vytvořených prostřednictvím platby. Stávající mandáty, zákazníci a předplatná si ponechávají své současné identifikátory a zůstávají použitelné. Kvůli této aktualizaci je nemusíte znovu vytvářet, migrovat záznamy zákazníků ani žádat zákazníky o opětovné autorizování mandátů.
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ů, zákazníků nebo předplatných — včetně platforem pro předplatné, fakturačního softwaru, úložišť CRM/dat zákazníků a dalších propojených systémů:
- Ukládání do databáze: Pro úplný identifikátor včetně předpony vyhraďte alespoň 40 znaků, pro ID mandátů, zákazníků a předplatných.
- Vlastní ověřování: Odstraňte kontroly, které vyžadují přesně 10 znaků za mdt_, cst_ nebo sub_. 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 jak stávající kratší identifikátory, tak nové delší identifikátory, pro mandáty, zákazníky i předplatná.
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ů, zákazníků a předplatných.
Změna identifikátorů nemění způsob, jakým používáte mandáty, zákazníky nebo předplatná pro opakované platby. Zkrácení nebo odmítnutí delšího identifikátoru však může vašemu propojení zabránit v načtení zákazníka, předplatného nebo mandátu či v jeho použití v žádosti o platbu. Pokud narazíte na problém, zkontrolujte, že 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.