Som en del av Mollies ansträngningar för att förbättra tillförlitligheten och säkerheten i våra system, arbetar vi på att förena våra API-resursidentifierare under en ny standard - betalnings- och orderidentifierare är nästa i tur.
Vad förändras?
Historiskt har våra API-identiteter bestått av 10 tecken eller färre (exklusive prefixet, exempel: tr_XYZXYZXYZX). Sedan början av året har vi uppgraderat dessa äldre identifierare till ett längre format, vilket lägger till ytterligare 4 till 12 tecken.
Nyare resurser - som Captures och Betalningslänkar - introducerades med detta utvidgade format från början. Återbetalningar, en äldre resurs, uppdaterades nyligen för att anta det nya formatet.
Nästa steg är att denna ändring kommer att gälla våra mest kritiska resurser: Betalningar (Skapa betalning -> Svar -> ID) och Beställningar (Skapa beställning -> Svar -> ID).
Vad betyder detta för dig?
Om du använder en av våra färdiga integrationer, som WooCommerce, Shopify eller Magento 2, bör du inte påverkas av denna ändring. Vi har granskat dessa integrationer och har inte identifierat några kompatibilitetsproblem.
Men om du har en egendefinierad integration med Mollie och/eller ytterligare nedströmsintegrationer som hanterar dessa betalningsreferenser (till exempel, ERP, orderhantering eller redovisningssystem), vänligen ta en stund för att granska följande:
- Databaslagring: Om du lagrar dessa identifierare, se till att fältets längd inte är begränsad till endast 10 tecken. Vi rekommenderar en fältlängd på minst 40 tecken eller mer för att säkerställa framtidssäkerhet.
- Egendefinierad validering: Se till att någon egendefinierad identifierarvalidering du har kan hantera det längre formatet. Vi rekommenderar att om du bestämmer dig för att validera tokenformatet, kontrollerar du endast att prefixet matchar dina förväntningar och undviker att validera resterande del av token.
Denna uppdatering bör inte störa betalningsbehandlingen, men felaktig hantering av de nya identifierarna kan leda till oenigheter. Du hittar mer information om den nya standarden här.
Förbered för en testtransaktion:
Vi kommer att utföra en enskild testtransaktion på varje unik profil/user_agent/client_id-kombination med de nya API-identiteterna den 5 juni, börjar klockan 2 på morgonen CET. Därför dirigerar vi den första transaktionen som görs för att använda det nya tokenformatet. Alla efterföljande transaktioner kommer att använda den gamla standarden igen, tills vi börjar utrullningen den 12 juni.
Om några problem uppstår efter detta test, ger vi dig möjlighet att temporärt välja bort förändringen. Vi skickar ett email till dig gällande valet att välja bort den 6 juni.
Felsökning
Om dina system oväntat har problem med att hantera det nya tokenformatet, kan du hantera transaktionen (ex. avbryta/återbetala/infånga) manuellt i din Mollie Dashboard genom att navigera till Ordrar/Betalningar, välja den relevanta transaktionen och utföra den önskade åtgärden där.
Observera: Vi håller en Q&A-session den 2 juni på Discord. Du kan dessutom ställa vilka frågor som helst i den här Discord-kanalen.
Tidplaner:
- 2 juni: Q&A-session - Delta på Discord
- 5 juni: Enstaka testtransaktion per unik profil/user-agent/client_id-kombination
- 6 juni: Uppföljningse-post, med möjlighet att temporärt välja bort den nya tokenförändringen
- 12 juni: Början av gradvis utrullning av det nya tokenformatet (exkl. val som sållas bort)
- 8 juli: 100 % utrullning av det nya tokenformatet (exkl. val som sållas bort)
-
31 december: Slut på opt-out-perioden, migrering av alla återstående profiler.