Som en del af Mollies bestræbelser på at forbedre pålideligheden og sikkerheden af vores systemer arbejder vi på at samle vores API-ressourceidentifikatorer under en ny standard - betalings- og ordrenumre er næste punkt.
Hvad ændrer sig?
Historisk set bestod vores API-identifikatorer af 10 tegn eller færre (uden præfiks, eksempel: tr_XYZXYZXYZX). Siden begyndelsen af året har vi opgraderet disse ældre identifikatorer til et længere format og tilføjet yderligere 4 til 12 tegn.
Nyere ressourcer - som Capture og Betalingslinks - blev introduceret med dette udvidede format fra starten. Refusioner, en ældre ressource, blev for nylig opdateret til at adoptere det nye format.
Dernæst vil denne ændring gælde for vores mest kritiske ressourcer: Betalinger (Opret betaling -> Respons -> ID) og Ordrer (Opret ordre -> Respons -> ID).
Hvad betyder dette for dig?
Hvis du bruger en af vores forudbyggede integrationer, såsom WooCommerce, Shopify eller Magento 2, vil du ikke opleve nogen påvirkning af denne ændring. Vi har gennemgået disse integrationer og har ikke identificeret nogen kompatibilitetsproblemer.
Men hvis du har en specialbygget integration med Mollie og/eller yderligere downstream-integrationer, der håndterer disse betalingsreferencer (for eksempel ERP, ordrehåndteringssystemer eller regnskabssystemer), skal du tage et øjeblik til at gennemgå følgende:
- Databasilagring: Hvis du opbevarer disse identifikatorer, skal du sikre dig, at feltlængden ikke er begrænset til kun 10 tegn. Vi anbefaler en feltlængde på mindst 40 tegn eller mere for at fremtidssikre sig.
- Brugerdefineret validering: Sørg for, at enhver brugerdefineret identifikatorvalidering, du har, kan rumme det længere format. Vi anbefaler, at hvis du vælger at validere tokenformatet, kun tjekker at præfikset matcher dine forventninger og undgår at validere resten af tokenet.
Denne opdatering burde ikke forstyrre betalingsbehandlingen, men forkert håndtering af de nye identifikatorer kan føre til uoverensstemmelser. Du kan finde yderligere information om den nye standard her.
Forbered til en testtransaktion:
Vi vil udføre en enkelt testtransaktion på hver unik profil/user_agent/client_id kombination ved at bruge de nye API-identifikatorer den 5. juni , startende kl. 02 CET. Derfor ruter vi den første transaktion til at bruge det nye tokenformat. Alle efterfølgende transaktioner vil igen bruge den gamle standard, indtil vi starter udrulningen den 12. juni.
Hvis der opstår problemer efter denne test, vil vi give dig muligheden for midlertidigt at fravælge ændringen. Vi sender dig en formular om fravalg på 6. juni.
Fejlfinding
Hvis dine systemer uventet har problemer med at håndtere det nye tokenformat, kan du manuelt administrere transaktionen (f.eks. annullere/refundere/erhverve) i dit Mollie Dashboard ved at navigere til Ordrer/Betalinger, vælge den relevante transaktion og udføre den ønskede handling der.
Bemærk: Vi afholder en Q&A-session den 2. juni på Discord. Derudover kan du stille alle spørgsmål i denne Discord-kanal.
Tidslinjer:
- 2. juni: Q&A-session - Deltag på Discord
- 5. juni: Enkel testtransaktion pr. unik profil/user-agent/client_id-kombination
- 6. juni: Opfølgningsmail, med mulighed for midlertidigt at fravælge den nye tokenændring
- 12. juni: Begyndelse af gradvis udrulning af det nye tokenformat (ekskl. fravalgs)
- 8. juli: 100% udrulning af det nye tokenformat (ekskl. fravalgs)
-
31. december: Slut på fravælgingsperiode, migrering af alle resterende profiler.