Actualizare a identificatorilor API pentru mandate

Actualizăm identificatorii mandatelor pentru a utiliza formatul mai lung de identificator API al Mollie’s. Aceasta urmează actualizării anterioare a identificatorilor API și aliniază mandatele la același standard.
 

Ce se schimbă?

Identificatorii mandatelor vechi conțin 10 caractere după prefixul mdt_. Mandatele nou create vor utiliza un identificator mai lung, cu până la 22 de caractere după prefix. Prefixul mdt_ rămâne același.

Această modificare se aplică mandatelor nou create, inclusiv mandatelor create automat printr-o plată. Mandatele existente își păstrează identificatorii actuali și rămân utilizabile. Nu trebuie să le recreați sau să le solicitați clienților să le autorizeze din nou din cauza acestei actualizări.

 

Ce înseamnă acest lucru pentru dumneavoastră?

Dacă întrețineți o integrare personalizată, verificați toate sistemele care stochează, validează sau transmit identificatori de mandate - inclusiv platforme de abonamente, software de facturare și alte sisteme conectate:

  • Stocarea în baza de date: Permiteți cel puțin 40 de caractere pentru identificatorul complet, inclusiv prefixul acestuia.
  • Validare personalizată: Eliminare verificărilor care impun exact 10 caractere după mdt_. 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 dvs. acceptă atât identificatorii existenți mai scurți, cât și identificatorii noi mai lungi.

Aceste recomandări privind stocarea și validarea urmează instrucțiunile noastre existente privind migrarea identificatorilor. De asemenea, puteți consulta 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 de mandate mai lungi.

Modificarea identificatorilor nu schimbă modul în care utilizați mandatele pentru plăți recurente. Totuși, trunchierea sau respingerea unui identificator mai lung ar putea împiedica integrarea dvs. să preia un mandat sau să îl utilizeze într-o cerere de plată. Dacă întâmpinați o problemă, verificați că identificatorul complet este păstrat în întreaga integrare și contactați Asistența Mollie cu eroarea API relevantă și identificatorul mandatului.