Actualizăm identificatorii de mandate, clienți și abonamente pentru a utiliza formatul Mollie mai lung pentru identificatorii API. Aceasta urmează actualizării anterioare a identificatorilor API și aliniază mandatele, clienții și abonamentele la același standard.
Ce se schimbă?
Identificatorii mandatelor vechi conțin 10 caractere după prefixul mdt_. Identificatorii vechi ai clienților conțin 10 caractere după prefixul cst_. Identificatorii vechi ai abonamentelor conțin 10 caractere după prefixul sub_. Mandatele, clienții și abonamentele nou create vor utiliza un identificator mai lung, cu până la 22 de caractere după prefixul respectiv. Prefixele rămân aceleași.
Această modificare se aplică mandatelor, clienților și abonamentelor nou create, inclusiv mandatelor create automat printr-o plată. Mandatele, clienții și abonamentele existente își păstrează identificatorii actuali și rămân utilizabile. Nu trebuie să le recreați, să migrați înregistrările clienților sau să solicitați clienților să autorizeze din nou mandatele din cauza acestei actualizări.
Ce înseamnă acest lucru pentru dumneavoastră?
Dacă întrețineți o integrare personalizată, verificați orice sisteme care stochează, validează sau transmit identificatori de mandate, clienți sau abonamente — inclusiv platforme de abonamente, software de facturare, CRM/depozite de date despre clienți și alte sisteme conectate:
- Stocarea în baza de date: Permiteți cel puțin 40 de caractere pentru identificatorul complet, inclusiv prefixul său, pentru identificatorii de mandate, clienți și abonamente.
- Validare personalizată: Eliminați verificările care necesită exact 10 caractere după mdt_, cst_ sau sub_. Dacă validați formatul, verificați prefixul preconizat fără a impune o lungime fixă pentru restul.
- Gestionarea identificatorilor: Stocați și trimiteți identificatorul complet exact așa cum este returnat de Mollie. Tratați-l ca pe un șir de caractere; nu trebuie să îl decodați sau interpretați.
- Compatibilitate: Asigurați-vă că integrarea dumneavoastră acceptă atât identificatorii existenți mai scurți, cât și identificatorii noi mai lungi, pentru mandate, clienți și abonamente.
Aceste recomandări privind stocarea și validarea urmează instrucțiunile noastre existente privind migrarea identificatorilor. Puteți consulta și documentația privind identificatorii API.
Dacă utilizați un plugin sau o integrare întreținută de un alt furnizor, verificați cu acel furnizor dacă acceptă identificatori mai lungi de mandate, clienți și abonamente.
Modificarea identificatorilor nu schimbă modul în care utilizați mandatele, clienții sau abonamentele pentru plăți recurente. Totuși, trunchierea sau respingerea unui identificator mai lung ar putea împiedica integrarea dumneavoastră să obțină un client, un abonament sau un mandat, sau să îl utilizeze într-o cerere de plată. Dacă întâmpinați o problemă, verificați dacă identificatorul complet este păstrat în întreaga integrare și contactați Asistența Mollie cu eroarea API relevantă și identificatorul.