Värskendame mandaadi, kliendi ja tellimuse identifikaatoreid, et kasutada Mollie pikemat API identifikaatorivormingut. See järgneb API identifikaatorite varasemale värskendusele ning viib mandaadid, kliendid ja tellimused vastavusse sama standardiga.
Mis muutub?
Varasemad volituste tunnused sisaldavad prefiksi mdt_ järel 10 märki. Varasemates kliendiidentifikaatorites on pärast cst_ eesliidet 10 märki. Varasemates tellimuse identifikaatorites on pärast sub_ eesliidet 10 märki. Äsja loodud mandaatide, klientide ja tellimuste puhul kasutatakse pikemat identifikaatorit, milles on vastava eesliite järel kuni 22 märki. Eesliited ise jäävad samaks.
See muudatus kehtib äsja loodud mandaatidele, klientidele ja tellimustele, sealhulgas makse kaudu automaatselt loodud mandaatidele. Olemasolevad mandaadid, kliendid ja tellimused säilitavad oma praegused identifikaatorid ning jäävad kasutatavaks. Te ei pea neid uuesti looma, kliendiandmeid migreerima ega paluma klientidel mandaate selle värskenduse tõttu uuesti volitada.
Mida see teile tähendab?
Kui haldate kohandatud intergratsiooni, vaadake üle kõik süsteemid, mis talletavad, valideerivad või edastavad mandaadi, kliendi või tellimuse identifikaatoreid — sealhulgas tellimusplatvormid, arveldustarkvara, CRM-i/kliendiandmete talletussüsteemid ja muud ühendatud süsteemid:
- Andmebaasi salvestus: Varuge mandaadi-, kliendi- ja tellimuse ID-de täielike identifikaatorite jaoks koos eesliitega vähemalt 40 märki.
- Kohandatud valideerimine: Eemaldage kontrollid, mis nõuavad täpselt 10 märki pärast mdt_, cst_ või sub_. Kui valideerite vormingut, kontrollige oodatud prefiksit, nõudmata ülejäänud osale kindlat pikkust.
- Tunnuste käsitlemine: Salvestage ja saatke täielik tunnus täpselt sellisena, nagu Mollie selle tagastab. Käsitlege seda stringina; te ei pea seda dekodeerima ega tõlgendama.
- Ühilduvus: Veenduge, et teie intergratsioon aktsepteerib nii olemasolevaid lühemaid identifikaatoreid kui ka uusi pikemaid identifikaatoreid mandaatide, klientide ja tellimuste puhul.
Need salvestamise ja valideerimise soovitused lähtuvad meie olemasolevatest tunnuste migreerimise juhistest. Samuti saate vaadata API identifikaatorite dokumentatsiooni.
Kui kasutate teise teenusepakkuja hallatavat pistikprogrammi või intergratsiooni, kontrollige selle teenusepakkuja käest, kas see toetab pikemaid mandaadi, kliendi ja tellimuse identifikaatoreid.
Identifikaatorite muudatus ei muuda seda, kuidas kasutate mandaate, kliente või tellimusi korduvate maksete jaoks. Pikema identifikaatori kärpimine või tagasilükkamine võib siiski takistada teie intergratsioonil kliendi, tellimuse või mandaadi hankimist või selle kasutamist maksetaotluses. Kui teil tekib probleem, kontrollige, et täielik identifikaator säiliks kogu teie intergratsioonis, ning võtke Mollie toega ühendust asjakohase API tõrketeate ja identifikaatoriga.