Vi oppdaterer identifikatorene for mandat, kunde og abonnement slik at de bruker Mollies lengre API-identifikatorformat. Dette følger den tidligere oppdateringen av API-identifikatorer og bringer mandater, kunder og abonnementer i tråd med samme standard.
Hva er i endring?
Eldre mandatidentifikatorer inneholder 10 tegn etter prefikset mdt_. Eldre kundeidentifikatorer inneholder 10 tegn etter prefikset cst_. Eldre abonnementsidentifikatorer inneholder 10 tegn etter prefikset sub_. Nylig opprettede mandater, kunder og abonnementer vil bruke en lengre identifikator, med opptil 22 tegn etter det respektive prefikset. Selve prefiksene forblir de samme.
Denne endringen gjelder nylig opprettede mandater, kunder og abonnementer, inkludert mandater som opprettes automatisk gjennom en betaling. Eksisterende mandater, kunder og abonnementer beholder sine nåværende identifikatorer og kan fortsatt brukes. Du trenger ikke å opprette dem på nytt, migrere kundeposter eller be kunder om å autorisere mandater på nytt på grunn av denne oppdateringen.
Hva betyr dette for deg?
Hvis du vedlikeholder en egendefinert integrasjon, bør du gjennomgå alle systemer som lagrer, validerer eller videresender identifikatorer for mandat, kunde eller abonnement — inkludert abonnementsplattformer, faktureringsprogramvare, CRM-/kundedatalagre og andre tilkoblede systemer:
- Databaselagring: Tillat minst 40 tegn for den fullstendige identifikatoren, inkludert prefikset, for ID-er for mandat, kunde og abonnement.
- Egendefinert validering: Fjern kontroller som krever nøyaktig 10 tegn etter mdt_, cst_ eller sub_. Hvis du validerer formatet, må du kontrollere det forventede prefikset uten å håndheve en fast lengde for resten.
- Håndtering av identifikatorer: Lagre og send den fullstendige identifikatoren nøyaktig slik den returneres av Mollie. Behandle den som en streng; du trenger ikke å dekode eller tolke den.
- Kompatibilitet: Sørg for at integrasjonen din godtar både eksisterende kortere identifikatorer og nye lengre identifikatorer, for mandater, kunder og abonnementer.
Disse anbefalingene for lagring og validering følger vår eksisterende veiledning for migrering av identifikatorer. Du kan også se dokumentasjonen for API-identifikatorer.
Hvis du bruker en plugin eller en integrasjon som vedlikeholdes av en annen leverandør, bør du sjekke med leverandøren at den støtter lengre identifikatorer for mandat, kunde og abonnement.
Endringen av identifikatorer endrer ikke hvordan du bruker mandater, kunder eller abonnementer for gjentakende betalinger. Å avkorte eller avvise en lengre identifikator kan imidlertid hindre integrasjonen din i å hente en kunde, et abonnement eller et mandat, eller i å bruke den i en betalingsforespørsel. Hvis du støter på et problem, bør du kontrollere at den fullstendige identifikatoren bevares gjennom hele integrasjonen og kontakte Mollie Support med den relevante API-feilen og identifikatoren.