Osana Mollien pyrkimyksiä parantaa järjestelmiemme luotettavuutta ja turvallisuutta, työskentelemme yhdistääksemme API-resurssitunnistimme uuden standardin mukaan - maksutunnisteet ja tilauksen tunnisteet ovat seuraavina.
Mikä on kehittymässä?
Historically, our API identifiers consisted of 10 characters or less (excluding the prefix, example: tr_XYZXYZXYZX). Vuoden alusta lähtien olemme päivittäneet nämä vanhat tunnisteet pidempään muotoon, lisäämällä 4-12 uutta merkkiä.
Uudemmat resurssit - kuten saamiset ja maksulinkit - otettiin käyttöön käyttäen tätä laajennettua muotoa alusta alkaen. Hyvitykset, vanhempi resurssi, päivitettiin äskettäin uuden muodon omaksumiseksi.
Seuraavaksi tämä muutos koskee tärkeimpiä resurssejamme: Maksut (Luo maksu -> Vastaus -> ID) ja Tilaukset (Luo tilaus -> Vastaus -> ID).
Mitä tämä tarkoittaa sinulle?
Jos käytät jotakin valmiista integraatioistamme, kuten WooCommercea, Shopifyta tai Magento 2:ta, tämän muutoksen ei pitäisi vaikuttaa toimintaasi. Olemme tarkastaneet nämä integraatiot emmekä ole tunnistaneet yhteensopivuusongelmia.
Kuitenkin, jos sinulla on räätälöity integrointi Mollien kanssa ja/tai lisä aliresurssit, jotka käsittelevät näitä maksureferenssejä (esimerkiksi ERP, tilauksen hallinta tai kirjanpitojärjestelmät), ota hetki aikaa tarkastellaksesi seuraavaa:
- Tietokantavarastointi: Jos tallennat näitä tunnisteita, varmista, ettei kentän pituus ole rajoitettu vain 10 merkkiin. Suosittelemme kentän pituutta vähintään 40 merkkiä tai enemmän tulevaisuutta varten.
- Räätälöity validointi: Varmista, että kaikki räätälöidyt tunnistajan validoinnit kykenevät käsittelemään pidempää muotoa. Suosittelemme, että jos päätät validoida token-muotoa, tarkistat vain, että etuliite vastaa odotuksiasi ja vältät validoimasta tokenin loppuosaa.
Tämä päivitys ei pitäisi häiritä maksujen käsittelyä, mutta uusien tunnisteiden virheellinen käsittely voisi johtaa eroon. Löydät lisätietoja uudesta standardista täältä.
Valmistaudu testitapahtumaan:
Suoritamme yhden testitapahtuman jokaiselle ainutlaatuiselle profiili/user_agent/client_id-yhdistelmälle käyttämällä uusia API-tunnisteita 5. kesäkuuta, alkaen klo 02.00 CET. Siksi suuntaamme ensimmäisen suoritettavan tapahtuman käyttämään uutta token-muotoa. Kaikki seuraavat tapahtumat käyttävät jälleen vanhaa standardia, kunnes aloitamme jakelun 12. kesäkuuta.
Jos testin jälkeen ilmenee ongelmia, annamme sinulle mahdollisuuden valita, että et osallistu muutokseen. Lähetämme sinulle sähköpostitse lomakkeen koskien opt-out-vaihtoehtoa 6. kesäkuuta.
Vianetsintä
Jos järjestelmäsi yllättäen kohtaavat ongelmia sen uuden token-muodon käsittelyssä, voit hallita tapahtumaa (esim. peruuttaa/hyvittää/saada) käsin Mollie Dashboard -palvelussasi siirtymällä kohtaan Tilaukset/Maksut, valitsemalla asiaankuuluvan tapahtuman ja suorittamalla halutun toiminnan siellä.
Huom.: Järjestämme K&V-tilaisuuden 2. kesäkuuta Discordissa Discord. Lisäksi voit esittää kysymyksiä tällä Discord-kanavalla.
Aikataulut:
- 2. kesäkuuta: K&V-tilaisuus - Liity mukaamme Discordissa
- 5. kesäkuuta: Yhden testitapahtuman suorittaminen jokaiselle ainutlaatuiselle profiilille/user-agentille/client_id-yhdistelmälle
- 6. kesäkuuta: Seurantaviesti, jossa opt-out-vaihtoehto muutokseen
- 12. kesäkuuta: Uuden token-muodon vähittäinen jakelu (ilman opt-out-vaihtoehtoa)
- 8. heinäkuuta: 100% jakelu uutta token-muotoa (ilman opt-out-vaihtoehtoa)
-
31. joulukuuta: Poiskytkentäjakson loppu, kaikkien jäljellä olevien profiilien siirto.