Vi uppdaterar identifierare för medgivanden, kunder och prenumerationer så att de använder Mollies längre API-identifierarformat. Detta följer den tidigare uppdateringen av API-identifierare och anpassar medgivanden, kunder och prenumerationer till samma standard.
Vad förändras?
Äldre identifikatorer för medgivanden innehåller 10 tecken efter prefixet mdt_. Äldre kundidentifierare innehåller 10 tecken efter prefixet cst_. Äldre prenumerationsidentifierare innehåller 10 tecken efter prefixet sub_. Nyskapade medgivanden, kunder och prenumerationer kommer att använda en längre identifierare, med upp till 22 tecken efter respektive prefix. Själva prefixen förblir desamma.
Den här ändringen gäller nyligen skapade medgivanden, kunder och prenumerationer, inklusive medgivanden som skapas automatiskt genom en betalning. Befintliga medgivanden, kunder och prenumerationer behåller sina nuvarande identifierare och kan fortsätta användas. Du behöver inte skapa dem på nytt, migrera kundposter eller be kunder att godkänna medgivanden igen på grund av den här uppdateringen.
Vad betyder detta för dig?
Om du underhåller en anpassad integration bör du granska alla system som lagrar, validerar eller överför identifierare för medgivanden, kunder eller prenumerationer — inklusive prenumerationsplattformar, faktureringsprogram, CRM/kunddatalager och andra anslutna system:
- Databaslagring: Tillåt minst 40 tecken för den fullständiga identifieraren, inklusive dess prefix, för ID:n för medgivanden, kunder och prenumerationer.
- Anpassad validering: Ta bort kontroller som kräver exakt 10 tecken efter mdt_, cst_ eller sub_. Om du validerar formatet kontrollerar du det förväntade prefixet utan att kräva en fast längd för återstoden.
- Hantering av identifikatorer: Lagra och skicka den fullständiga identifikatorn exakt som den returneras av Mollie. Behandla den som en sträng; du behöver inte avkoda eller tolka den.
- Kompatibilitet: Se till att din integration accepterar både befintliga kortare identifierare och nya längre identifierare, för medgivanden, kunder och prenumerationer.
Dessa rekommendationer för lagring och validering följer vår befintliga vägledning för migrering av identifikatorer. Du kan också läsa dokumentationen för API-identifierare.
Om du använder ett insticksprogram eller en integration som underhålls av en annan leverantör, kontrollera med den leverantören att den stöder längre identifierare för medgivanden, kunder och prenumerationer.
Ändringen av identifierare påverkar inte hur du använder medgivanden, kunder eller prenumerationer för återkommande betalningar. Att förkorta eller avvisa en längre identifierare kan dock hindra din integration från att hämta en kund, prenumeration eller ett medgivande, eller från att använda den i en betalningsbegäran. Om du stöter på ett problem, kontrollera att den fullständiga identifieraren bevaras i hela din integration och kontakta Mollie Support med det relevanta API-felet och identifieraren.