Päivitämme valtuutus-, asiakas- ja tilaustunnisteet käyttämään Mollien pidempää API-tunnistemuotoa. Tämä seuraa aiempaa API-tunnisteiden päivitystä ja yhdenmukaistaa valtuutukset, asiakkaat ja tilaukset saman standardin mukaisiksi.
Mikä muuttuu?
Vanhoissa valtuutustunnisteissa on 10 merkkiä etuliitteen mdt_ jälkeen. Vanhoissa asiakastunnisteissa on 10 merkkiä etuliitteen cst_ jälkeen. Vanhoissa tilaustunnisteissa on 10 merkkiä etuliitteen sub_ jälkeen. Uusissa valtuutuksissa, asiakkaissa ja tilauksissa käytetään pidempää tunnistetta, jossa on enintään 22 merkkiä vastaavan etuliitteen jälkeen. Itse etuliitteet pysyvät samoina.
Tämä muutos koskee uusia valtuutuksia, asiakkaita ja tilauksia, mukaan lukien maksun kautta automaattisesti luotuja valtuutuksia. Nykyiset valtuutukset, asiakkaat ja tilaukset säilyttävät nykyiset tunnisteensa ja ovat edelleen käytettävissä. Tämän päivityksen vuoksi niitä ei tarvitse luoda uudelleen, asiakastietoja ei tarvitse siirtää eikä asiakkaita tarvitse pyytää valtuuttamaan valtuutuksia uudelleen.
Mitä tämä tarkoittaa sinulle?
Jos ylläpidät mukautettua integraatiota, tarkista kaikki järjestelmät, jotka tallentavat, validoivat tai välittävät valtuutus-, asiakas- tai tilaustunnisteita — mukaan lukien tilausalustat, laskutusohjelmistot, CRM-/asiakastietovarastot ja muut yhdistetyt järjestelmät:
- Tietokantatallennus: Varaa vähintään 40 merkkiä täydelliselle tunnisteelle, sen etuliite mukaan lukien, valtuutus-, asiakas- ja tilaustunnuksissa.
- Mukautettu validointi: Poista tarkistukset, jotka edellyttävät täsmälleen 10 merkkiä tunnisteiden mdt_, cst_ tai sub_ jälkeen. Jos validoit muodon, tarkista odotettu etuliite asettamatta kiinteää pituutta loppuosalle.
- Tunnisteiden käsittely: Tallenna ja lähetä täydellinen tunniste täsmälleen siinä muodossa kuin Mollie palauttaa sen. Käsittele sitä merkkijonona; sinun ei tarvitse purkaa tai tulkita sitä.
- Yhteensopivuus: Varmista, että integraatiosi hyväksyy sekä nykyiset lyhyemmät että uudet pidemmät tunnisteet valtuutuksissa, asiakkaissa ja tilauksissa.
Nämä tallennus- ja validointisuositukset noudattavat nykyisiä tunnisteiden siirto-ohjeitamme. Voit myös tutustua API-tunnisteiden dokumentaatioon.
Jos käytät lisäosaa tai toisen palveluntarjoajan ylläpitämää integraatiota, varmista palveluntarjoajalta, että se tukee pidempiä valtuutus-, asiakas- ja tilaustunnisteita.
Tunnistemuutos ei muuta tapaa, jolla käytät valtuutuksia, asiakkaita tai tilauksia toistuviin maksuihin. Pidemmän tunnisteen katkaiseminen tai hylkääminen voi kuitenkin estää integraatiotasi hakemasta asiakasta, tilausta tai valtuutusta tai käyttämästä sitä maksupyynnössä. Jos kohtaat ongelman, varmista, että täydellinen tunniste säilyy koko integraatiossasi, ja ota yhteyttä Mollien tukeen sekä asiaankuuluvan API-virheen että tunnisteen kanssa.