Als onderdeel van Mollie's inspanningen om de betrouwbaarheid en veiligheid van onze systemen te verbeteren, werken we aan het uniformeren van onze API-resources onder een nieuwe standaard - betalings- en orderidentificatoren staan nu op de agenda.
Wat is er aan het evolueren?
Historisch gezien bestonden onze API-identificatoren uit 10 of minder tekens (exclusief het voorvoegsel, voorbeeld: tr_XYZXYZXYZX). Sinds het begin van het jaar upgraden we deze oude identificatoren naar een langer formaat en voegen we 4 tot 12 extra tekens toe.
Nieuwere resources - zoals Captures en Betalingslinks - zijn vanaf het begin met dit uitgebreide formaat geïntroduceerd. Terugbetalingen, een oudere resource, zijn onlangs bijgewerkt om het nieuwe formaat aan te nemen.
Vervolgens zal deze wijziging van toepassing zijn op onze meest kritieke resources: Betalingen (Betaling aanmaken -> Response -> ID) en Bestellingen (Bestelling aanmaken -> Response -> ID).
Wat betekent dit voor jou?
Als je een van onze kant-en-klare integraties gebruikt, zoals WooCommerce, Shopify of Magento 2, zul je geen gevolgen merken van deze wijziging. We hebben deze integraties beoordeeld en hebben geen compatibiliteitsproblemen geïdentificeerd.
Als je echter een op maat gemaakte integratie met Mollie en/of aanvullende downstream-integraties hebt die deze betalingsreferenties afhandelen (bijvoorbeeld ERP, orderbeheer of boekhoudsystemen), neem dan even de tijd om het volgende te bekijken:
- Databaseopslag: Als je deze identificatoren opslaat, zorg er dan voor dat de veldlengte niet beperkt is tot slechts 10 tekens. We raden een veldlengte aan van minimaal 40 tekens of meer voor toekomstbestendigheid.
- Aangepaste validatie: Zorg ervoor dat elke aangepaste validatie van identificatoren die je hebt, het langere formaat kan accommoderen. We raden aan dat als je besluit het tokenformaat te valideren, je alleen controleert of het voorvoegsel overeenkomt met je verwachtingen en het overige van het token niet valideert.
Deze update zou de betalingsverwerking niet moeten verstoren, maar een verkeerde behandeling van de nieuwe identificatoren kan leiden tot mismatches. Je vindt meer informatie over de nieuwe standaard hier.
Bereid je voor op een testtransactie:
We zullen een enkele testtransactie uitvoeren op elke unieke profiel/user_agent/client_id combinatie met de nieuwe API-identificatoren op 5 juni, beginnend om 2 uur CET. Daarom leiden we de eerste transactie die wordt gemaakt om het nieuwe tokenformaat te gebruiken. Alle daaropvolgende transacties gebruiken weer de oude standaard, totdat we op 12 juni beginnen met de uitrol.
Als er na deze test problemen optreden, geven we je de keuze om tijdelijk van de wijziging af te zien. We sturen je op 6 juni een formulier met betrekking tot de uitschrijving.
Probleemoplossing
Als je systemen onverwacht problemen hebben met het verwerken van het nieuwe tokenformaat, kun je de transactie (bijv. annuleren/terugbetalen/vastleggen) handmatig beheren in je Mollie Dashboard door naar Bestellingen/Betalingen te navigeren, de relevante transactie te selecteren en daar de gewenste actie uit te voeren.
Let op: We organiseren een Q&A-sessie op 2 juni gehost op Discord. Daarnaast kun je al je vragen stellen in dit Discord-kanaal.
Tijdlijnen:
- 2 juni: Q&A-sessie - Doe mee op Discord
- 5 juni: Enkele testtransactie per unieke profiel/user-agent/client_id combinatie
- 6 juni: Vervolg-e-mail, met de optie om tijdelijk af te zien van de wijziging van het nieuwe token
- 12 juni: Begin van de geleidelijke uitrol van het nieuwe tokenformaat (excl. afmeldingen)
- 8 juli: 100% uitrol van het nieuwe tokenformaat (excl. afmeldingen)
-
31 december: Einde van de opt-outperiode, migratie van alle resterende profielen.