Stiamo aggiornando gli identificatori di mandati, clienti e abbonamenti affinché utilizzino il formato di identificatore API più lungo di Mollie. Questa modifica segue il precedente aggiornamento degli identificatori API e allinea mandati, clienti e abbonamenti allo stesso standard.
Cosa sta cambiando?
Gli identificatori dei mandati legacy contengono 10 caratteri dopo il prefisso mdt_. Gli identificatori legacy dei clienti contengono 10 caratteri dopo il prefisso cst_. Gli identificatori legacy degli abbonamenti contengono 10 caratteri dopo il prefisso sub_. I mandati, i clienti e gli abbonamenti creati di recente utilizzeranno un identificatore più lungo, con un massimo di 22 caratteri dopo il rispettivo prefisso. I prefissi stessi rimangono invariati.
Questa modifica si applica ai mandati, ai clienti e agli abbonamenti creati di recente, inclusi i mandati creati automaticamente tramite un pagamento. I mandati, i clienti e gli abbonamenti esistenti mantengono i loro identificatori attuali e restano utilizzabili. Non devi ricrearli, migrare i dati dei clienti o chiedere ai clienti di autorizzare nuovamente i mandati a causa di questo aggiornamento.
Cosa significa per te?
Se gestisci una integrazione personalizzata, verifica tutti i sistemi che archiviano, convalidano o trasmettono identificatori di mandati, clienti o abbonamenti — incluse piattaforme di abbonamento, software di fatturazione, archivi CRM/dati dei clienti e altri sistemi collegati:
- Archiviazione nel database: Consenti almeno 40 caratteri per l'identificatore completo, incluso il relativo prefisso, per gli ID di mandati, clienti e abbonamenti.
- Convalida personalizzata: Rimuovi i controlli che richiedono esattamente 10 caratteri dopo mdt_, cst_ o sub_. 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ù corti sia i nuovi identificatori più lunghi, per mandati, clienti e abbonamenti.
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 una integrazione gestita da un altro fornitore, verifica con quel fornitore che supporti identificatori di mandati, clienti e abbonamenti più lunghi.
La modifica degli identificatori non cambia il modo in cui utilizzi mandati, clienti o abbonamenti per i Pagamenti ricorrenti. Tuttavia, troncare o rifiutare un identificatore più lungo potrebbe impedire alla tua integrazione di recuperare un cliente, un abbonamento o 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 e l'identificatore pertinenti.