Estamos a atualizar os identificadores de mandatos para utilizarem o formato mais longo de identificadores da API da Mollie. Isto segue-se à atualização anterior dos identificadores da API e alinha os mandatos com a mesma norma.
O que está a mudar?
Os identificadores de mandatos legados contêm 10 caracteres após o prefixo mdt_. Os mandatos recém-criados utilizarão um identificador mais longo, com até 22 caracteres após o prefixo. O prefixo mdt_ mantém-se inalterado.
Esta alteração aplica-se a mandatos recém-criados, incluindo mandatos criados automaticamente através de um pagamento. Os mandatos existentes mantêm os respetivos identificadores atuais e continuam utilizáveis. Não precisa de os recriar nem de pedir aos Clientes que os autorizem novamente devido a esta atualização.
O que significa isto para si?
Se mantiver uma Integração personalizada, reveja quaisquer sistemas que armazenem, validem ou transmitam identificadores de mandatos - incluindo plataformas de subscrição, software de faturação e outros sistemas ligados:
- Armazenamento na base de dados: Permita pelo menos 40 caracteres para o identificador completo, incluindo o respetivo prefixo.
- Validação personalizada: Remova as verificações que exigem exatamente 10 caracteres após mdt_. 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.
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 sobre identificadores da API.
Se utilizar um plugin ou uma Integração mantida por outro fornecedor, confirme com esse fornecedor que suporta identificadores de mandatos mais longos.
A alteração do identificador não modifica a forma como utiliza os mandatos para Pagamentos recorrentes. No entanto, truncar ou rejeitar um identificador mais longo pode impedir a sua Integração de obter um 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 relevante da API e o identificador do mandato.