Aktualizujeme identifikátory mandátov, zákazníkov a predplatných 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, zákazníkov a predplatné do súladu s rovnakým štandardom.
Čo sa mení?
Staršie identifikátory mandátov obsahujú 10 znakov za predponou mdt_. Staršie identifikátory zákazníkov obsahujú 10 znakov za predponou cst_. Staršie identifikátory predplatných obsahujú 10 znakov za predponou sub_. Novo vytvorené mandáty, zákazníci a predplatné budú používať dlhší identifikátor s až 22 znakmi za príslušnou predponou. Samotné predpony zostávajú rovnaké.
Táto zmena sa vzťahuje na novo vytvorené mandáty, zákazníkov a predplatné vrátane mandátov vytvorených automaticky prostredníctvom platby. Existujúce mandáty, zákazníci a predplatné si zachovávajú svoje aktuálne identifikátory a naďalej sa dajú používať. V dôsledku tejto aktualizácie ich nemusíte znovu vytvárať, migrovať záznamy zákazníkov ani žiadať zákazníkov, aby mandáty znovu autorizovali.
Č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, zákazníkov alebo predplatných — vrátane platforiem pre predplatné, fakturačného softvéru, CRM/úložísk údajov o zákazníkoch a ďalších prepojených systémov:
- Ukladanie v databáze: Pre úplný identifikátor vrátane predpony povoľte aspoň 40 znakov pre ID mandátov, zákazníkov a predplatných.
- Vlastné overovanie: Odstráňte kontroly, ktoré vyžadujú presne 10 znakov za mdt_, cst_ alebo sub_. 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 pre mandáty, zákazníkov a predplatné.
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 tohto poskytovateľa, či podporuje dlhšie identifikátory mandátov, zákazníkov a predplatných.
Zmena identifikátorov nemení spôsob, akým používate mandáty, zákazníkov alebo predplatné na opakované platby. Skrátenie alebo odmietnutie dlhšieho identifikátora však môže vašej integrácii zabrániť v načítaní zákazníka, predplatného alebo mandátu, prípadne v jeho použití v žiadosti o platby. Ak narazíte na problém, skontrolujte, či sa v celej integrácii zachováva úplný identifikátor, a kontaktujte podporu Mollie s príslušnou chybou API a identifikátorom.