Come parte degli sforzi di Mollie per migliorare l'affidabilità e la sicurezza dei nostri sistemi, stiamo lavorando per unificare i nostri identificatori di risorse API secondo un nuovo standard - identificatori di pagamento e ordine sono i prossimi in lista.
Cosa sta evolvendo?
Storicamente, i nostri identificatori API consistevano di 10 caratteri o meno (escludendo il prefisso, esempio: tr_XYZXYZXYZX). Dall'inizio dell'anno, abbiamo aggiornato questi identificatori legacy a un formato più lungo, aggiungendo ulteriori 4 a 12 caratteri.
Risorse più recenti - come Catture e Link di Pagamento - sono state introdotte utilizzando questo formato esteso fin dall'inizio. I rimborsi, una risorsa più vecchia, sono stati recentemente aggiornati per adottare il nuovo formato.
Successivamente, questa modifica verrà applicata alle nostre risorse più critiche: Pagamenti (Crea un pagamento -> Risposta -> ID) e Ordini (Crea un ordine -> Risposta -> ID).
Cosa significa questo per te?
Se stai usando una delle nostre integrazioni preconfigurate, come WooCommerce, Shopify o Magento 2, non dovresti riscontrare alcun impatto da questa modifica. Abbiamo esaminato queste integrazioni e non abbiamo identificato problemi di compatibilità.
Tuttavia, se hai una integrazione personalizzata con Mollie e/o integrazioni a valle aggiuntive che gestiscono questi riferimenti di pagamento (ad esempio, ERP, gestione ordini o sistemi contabili), ti preghiamo di prendere un momento per esaminare quanto segue:
- Archiviazione nel database: Se memorizzi questi identificatori, assicurati che la lunghezza del campo non sia limitata a solo 10 caratteri. Consigliamo una lunghezza del campo di almeno 40 caratteri o più per essere a prova di futuro.
- Validazione personalizzata: Assicurati che qualsiasi validazione personalizzata degli identificatori che hai possa accogliere il formato più lungo. Consigliamo che, se decidi di convalidare il formato del token, controlli solo che il prefisso corrisponda alle tue aspettative ed eviti di convalidare il resto del token.
Questo aggiornamento non dovrebbe interrompere l'elaborazione dei pagamenti, ma una gestione errata dei nuovi identificatori potrebbe portare a discrepanze. Puoi trovare ulteriori informazioni sul nuovo standard qui.
Prepara una transazione di prova:
Effettueremo una singola transazione di prova su ogni combinazione unica di profilo/user_agent/client_id utilizzando i nuovi identificatori API il 5 Giugno, a partire dalle 2 del mattino CET. Pertanto reindirizziamo la prima transazione effettuata a utilizzare il nuovo formato del token. Tutte le transazioni successive utilizzeranno nuovamente il vecchio standard, fino a quando inizieremo il roll-out il 12 Giugno.
Se ci sono problemi dopo questo test, ti daremo la possibilità di rinunciare temporaneamente al cambiamento. Ti invieremo un'email con un modulo riguardo alla rinuncia il 6 Giugno.
Risoluzione dei problemi
Nel caso in cui i tuoi sistemi abbiano problemi inaspettati nel gestire il nuovo formato del token, puoi gestire la transazione (es. annullare/rimborsare/catturare) manualmente nella tua Mollie Dashboard navigando verso Ordini/Pagamenti, selezionando la transazione rilevante e eseguendo l'azione desiderata lì.
Nota: Organizziamo una sessione di domande e risposte il 2 giugno su Discord. Inoltre, puoi fare qualsiasi domanda in questo canale Discord.
Tempistiche:
- 2 giugno: sessione di domande e risposte - Unisciti a noi su Discord
- 5 Giugno: Transazione di Prova Singola per ogni combinazione unica di profilo/user-agent/client_id
- 6 Giugno: Email di follow-up, con opzione per rinunciare temporaneamente al cambiamento del nuovo token
- 12 Giugno: Inizio del roll-out graduale del nuovo formato del token (escl. rinunce)
- 8 Luglio: 100% roll-out del nuovo formato del token (escl. rinunce)
-
31 dicembre: Fine del periodo di opt-out, migrazione di tutti i profili restanti.