Estamos a atualizar os identificadores de mandatos, clientes e subscrições para utilizarem o formato de identificador de API mais longo da Mollie. Isto segue-se à atualização anterior dos identificadores de API e alinha os mandatos, clientes e subscrições com a mesma norma.
O que está a mudar?
Os identificadores de mandatos legados contêm 10 caracteres após o prefixo mdt_. Os identificadores de clientes antigos contêm 10 caracteres após o prefixo cst_. Os identificadores de subscrições antigos contêm 10 caracteres após o prefixo sub_. Os mandatos, clientes e subscrições criados recentemente utilizarão um identificador mais longo, com até 22 caracteres após o respetivo prefixo. Os próprios prefixos mantêm-se iguais.
Esta alteração aplica-se a mandatos, clientes e subscrições criados recentemente, incluindo mandatos criados automaticamente através de um pagamento. Os mandatos, clientes e subscrições existentes mantêm os seus identificadores atuais e continuam a poder ser utilizados. Não precisa de os recriar, migrar registos de clientes, nem pedir aos clientes que autorizem novamente os mandatos devido a esta atualização.
O que significa isto para si?
Se mantiver uma integração personalizada, reveja todos os sistemas que armazenam, validam ou transmitem identificadores de mandatos, clientes ou subscrições — incluindo plataformas de subscrições, software de faturação, repositórios de dados de CRM/clientes e outros sistemas ligados:
- Armazenamento na base de dados: Permita pelo menos 40 caracteres para o identificador completo, incluindo o respetivo prefixo, para IDs de mandatos, clientes e subscrições.
- Validação personalizada: Remova as verificações que exigem exatamente 10 caracteres após mdt_, cst_ ou sub_. Se validar o formato, verifique o prefixo esperado sem impor um comprimento fixo ao restante.
- Processamento de identificadores: Armazene e envie o identificador completo exatamente como é devolvido pela Mollie. Trate-o como uma cadeia de carateres; não precisa de o descodificar nem interpretar.
- Compatibilidade: Certifique-se de que a sua integração aceita tanto os identificadores mais curtos existentes como os novos identificadores mais longos, para mandatos, clientes e subscrições.
Estas recomendações de armazenamento e validação seguem as nossas orientações existentes sobre a migração de identificadores. Também pode consultar a documentação dos identificadores de API.
Se utilizar um plugin ou uma integração mantida por outro fornecedor, confirme junto desse fornecedor se suporta identificadores de mandatos, clientes e subscrições mais longos.
A alteração dos identificadores não altera a forma como utiliza mandatos, clientes ou subscrições para pagamentos recorrentes. No entanto, truncar ou rejeitar um identificador mais longo pode impedir a sua integração de obter um cliente, subscrição ou mandato, ou de o utilizar num pedido de pagamento. Se encontrar um problema, verifique se o identificador completo é preservado em toda a sua integração e contacte o Apoio da Mollie com o erro de API e o identificador relevantes.