Stiamo aggiornando gli identificatori dei mandati per utilizzare il formato più lungo degli identificatori API di Mollie. Ciò fa seguito al precedente aggiornamento degli identificatori API e uniforma i mandati allo stesso standard.
Cosa sta cambiando?
Gli identificatori dei mandati legacy contengono 10 caratteri dopo il prefisso mdt_. I mandati creati di recente utilizzeranno un identificatore più lungo, con un massimo di 22 caratteri dopo il prefisso. Il prefisso mdt_ rimane invariato.
Questa modifica si applica ai mandati creati di recente, compresi quelli creati automaticamente tramite un pagamento. I mandati esistenti mantengono i loro identificatori attuali e restano utilizzabili. Non devi ricrearli né chiedere ai clienti di autorizzarli nuovamente a causa di questo aggiornamento.
Cosa significa per te?
Se gestisci un'Integrazione personalizzata, controlla tutti i sistemi che archiviano, convalidano o trasmettono identificatori di mandato - incluse le piattaforme di abbonamento, i software di fatturazione e altri sistemi connessi:
- Archiviazione nel database: Consenti almeno 40 caratteri per l'identificatore completo, incluso il prefisso.
- Convalida personalizzata: Rimuovi i controlli che richiedono esattamente 10 caratteri dopo mdt_. Se convalidi il formato, verifica il prefisso previsto senza imporre una lunghezza fissa per la parte restante.
- Gestione degli identificatori: Archivia e invia l'identificatore completo esattamente come restituito da Mollie. Trattalo come una stringa; non devi decodificarlo né interpretarlo.
- Compatibilità: Assicurati che la tua integrazione accetti sia gli identificatori esistenti più brevi sia i nuovi identificatori più lunghi.
Queste raccomandazioni per l'archiviazione e la convalida seguono la nostra guida esistente alla migrazione degli identificatori. Puoi anche consultare la documentazione sugli identificatori API.
Se utilizzi un plugin o un'integrazione gestita da un altro fornitore, verifica con quel fornitore che supporti identificatori di mandati più lunghi.
La modifica dell'identificatore non altera il modo in cui utilizzi i mandati per i pagamenti ricorrenti. Tuttavia, troncare o rifiutare un identificatore più lungo potrebbe impedire alla tua integrazione di recuperare un mandato o di utilizzarlo in una richiesta di pagamento. Se riscontri un problema, verifica che l'identificatore completo venga mantenuto in tutta la tua integrazione e contatta l'Assistenza Mollie indicando l'errore API pertinente e l'identificatore del mandato.