Aktualizujeme identifikátory mandátov tak, aby používali dlhší formát identifikátorov API spoločnosti Mollie. Táto zmena nadväzuje na predchádzajúcu aktualizáciu identifikátorov API a uvádza mandáty do súladu s rovnakým štandardom.
Čo sa mení?
Staršie identifikátory mandátov obsahujú 10 znakov za predponou mdt_. Novo vytvorené mandáty budú používať dlhší identifikátor s až 22 znakmi za predponou. Predpona mdt_ zostáva rovnaká.
Táto zmena sa vzťahuje na novo vytvorené mandáty vrátane mandátov vytvorených automaticky prostredníctvom platby. Existujúce mandáty si zachovávajú svoje aktuálne identifikátory a naďalej ich možno používať. V dôsledku tejto aktualizácie ich nemusíte vytvárať znova ani žiadať zákazníkov o ich opätovné autorizovanie.
Čo to pre vás znamená?
Ak spravujete vlastnú integráciu, skontrolujte všetky systémy, ktoré ukladajú, overujú alebo prenášajú identifikátory mandátov - vrátane platforiem na správu predplatného, fakturačného softvéru a ďalších prepojených systémov:
- Ukladanie do databázy: Pre úplný identifikátor vrátane predpony vyhraďte aspoň 40 znakov.
- Vlastné overovanie: Odstráňte kontroly, ktoré vyžadujú presne 10 znakov za mdt_. Ak overujete formát, skontrolujte očakávanú predponu bez vynucovania pevnej dĺžky zvyšku.
- Spracovanie identifikátorov: Úplný identifikátor ukladajte a odosielajte presne tak, ako ho vráti Mollie. Považujte ho za reťazec; nemusíte ho dekódovať ani interpretovať.
- Kompatibilita: Uistite sa, že vaša integrácia prijíma existujúce kratšie identifikátory aj nové dlhšie identifikátory.
Tieto odporúčania týkajúce sa ukladania a overovania vychádzajú z našich existujúcich pokynov na migráciu identifikátorov. Môžete si tiež pozrieť dokumentáciu k identifikátorom API.
Ak používate doplnok alebo integráciu spravovanú iným poskytovateľom, overte si u daného poskytovateľa, či podporuje dlhšie identifikátory mandátov.
Zmena identifikátorov nemení spôsob, akým používate mandáty na opakované platby. Skrátenie alebo odmietnutie dlhšieho identifikátora však môže vašej integrácii zabrániť v načítaní mandátu alebo jeho použití v žiadosti o platbu. Ak narazíte na problém, skontrolujte, či je úplný identifikátor zachovaný v celej vašej integrácii, a kontaktujte podporu Mollie s príslušnou chybou API a identifikátorom mandátu.