Som en del av Mollies arbeid for å forbedre påliteligheten og sikkerheten til systemene våre, jobber vi med å samle våre API-ressursidentifikatorer under en ny standard - betalings- og ordreidentifikatorer er neste i rekken.
Hva er i endring?
Historisk sett besto API-identifikatorene våre av 10 tegn eller færre (ekskludert prefikset, eksempel: tr_XYZXYZXYZX). Siden begynnelsen av året har vi oppgradert disse eldre identifikatorene til et lengre format, ved å legge til 4 til 12 ekstra tegn.
Nyere ressurser - som Captures og Payment Links - ble introdusert ved å bruke dette utvidede formatet fra starten av. Tilbakebetalinger, en eldre ressurs, ble nylig oppdatert for å ta i bruk det nye formatet.
Deretter vil denne endringen gjelde for våre mest kritiske ressurser: Betalinger (Opprett betaling -> Respons -> ID) og Ordrer (Opprett ordre -> Respons -> ID).
Hva betyr dette for deg?
Hvis du bruker en av våre ferdiglagde integrasjoner, som WooCommerce, Shopify eller Magento 2, skal du ikke oppleve noen påvirkning av denne endringen. Vi har gjennomgått disse integrasjonene og har ikke identifisert noen kompatibilitetsproblemer.
Imidlertid, hvis du har en egendefinert integrasjon med Mollie og/eller tilleggssystemer som håndterer disse betalingsreferansene (for eksempel ERP, ordrehåndterings- eller regnskapssystemer), vennligst ta et øyeblikk for å gjennomgå følgende:
- Database lagring: Hvis du lagrer disse identifikatorene, sørg for at feltlengden ikke er begrenset til bare 10 tegn. Vi anbefaler en feltlengde på minst 40 tegn eller mer for å sikre fremtiden.
- Egendefinert validering: Sørg for at eventuell egendefinert identifikatorvalidering du har kan håndtere det lengre formatet. Vi anbefaler at hvis du bestemmer deg for å validere tokenformatet, sjekker du bare at prefikset samsvarer med forventningene dine og unngår å validere resten av tokenet.
Denne oppdateringen skal ikke forstyrre betalingsbehandling, men feilaktig håndtering av de nye identifikatorene kan føre til usamsvar. Du finner mer informasjon om den nye standarden her.
Forbered deg på en testtransaksjon:
Vi vil utføre en enkel testtransaksjon på hver unik profil/bruger-agent/klient-ID kombinasjon ved å bruke de nye API-identifikatorene den 5. juni, startende kl 02.00 CET. Derfor ruter vi den første transaksjonen som gjøres til å bruke det nye tokenformatet. Alle påfølgende transaksjoner vil bruke den gamle standarden igjen, til vi starter utrullingen den 12. juni.
Hvis det oppstår problemer etter denne testen, vil vi gi deg muligheten til midlertidig å melde deg ut av endringen. Vi sender deg en e-post med et skjema angående utsendingen den 6. juni.
Feilsøking
Hvis systemene dine uventet har problemer med å håndtere det nye tokenformatet, kan du administrere transaksjonen (f.eks. kansellere/refundere/fange) manuelt i ditt Mollie Dashboard ved å navigere til Ordre/Betalinger, velge den aktuelle transaksjonen og utføre ønsket handling der.
Merk: Vi holder en Q&A-økt 2. juni på Discord. I tillegg kan du stille alle spørsmål i denne Discord-kanalen.
Tidslinjer:
- 2. juni: Q&A-økt - Bli med oss på Discord
- 5. juni: Enkel testtransaksjon per unik profil/bruger-agent/klient-ID kombinasjon
- 6. juni: Oppfølgings-e-post, med mulighet til å midlertidig melde deg ut av den nye token-endringen
- 12. juni: Begynnelse av gradvis utrulling av nytt tokenformat (uten opt-outs)
- 8. juli: 100% utrulling av nytt tokenformat (uten opt-outs)
-
31. desember: Slutt på reservasjonsperioden, migrering av alle gjenværende profiler.