Como parte dos esforços da Mollie para melhorar a confiabilidade e segurança dos nossos sistemas, estamos trabalhando na unificação dos nossos identificadores de recursos da API sob um novo padrão - identificadores de pagamento e de pedidos são os próximos na fila.
O que está mudando?
Historicamente, nossos identificadores da API consistiam em 10 caracteres ou menos (excluindo o prefixo, exemplo: tr_XYZXYZXYZX). Desde o início do ano, temos atualizado esses identificadores legados para um formato mais longo, adicionando de 4 a 12 caracteres adicionais.
Recursos mais novos - como Capturas e Links de Pagamento - foram introduzidos usando este formato estendido desde o início. Reembolsos, um recurso mais antigo, foram recentemente atualizados para adotar o novo formato.
Em seguida, essa alteração será aplicada aos nossos recursos mais críticos: Pagamentos (Criar pagamento -> Resposta -> ID) e Encomendas (Criar encomenda -> Resposta -> ID).
O que isso significa para você?
Se estiver a usar uma das nossas integrações pré-configuradas, como WooCommerce, Shopify ou Magento 2, não deverá sentir impacto com esta alteração. Revisamos essas integrações e não identificamos quaisquer problemas de compatibilidade.
No entanto, se você tiver uma integração personalizada com a Mollie e/ou integrações adicionais a jusante que lidam com essas referências de pagamento (por exemplo, ERP, gestão de pedidos ou sistemas contábeis), por favor, reserve um momento para revisar o seguinte:
- Armazenamento no banco de dados: Se você armazenar esses identificadores, certifique-se de que o comprimento do campo não esteja limitado a apenas 10 caracteres. Recomendamos um comprimento de campo de pelo menos 40 caracteres ou mais para garantir a proteção futura.
- Validação personalizada: Certifique-se de que qualquer validação de identificador personalizada que você tiver possa acomodar o formato mais longo. Recomendamos que, se você decidir validar o formato do token, apenas verifique se o prefixo coincide com suas expectativas e evite validar o restante do token.
Esta atualização não deve interromper o processamento de pagamentos, mas um manuseio incorreto dos novos identificadores pode levar a incompatibilidades. Pode consultar mais informações sobre o novo padrão aqui.
Prepare-se para uma transação de teste:
Faremos uma única transação de teste em cada combinação única de perfil/user_agent/client_id usando os novos identificadores de API em 5 de Junho, começando às 2h CET. Portanto, direcionamos a primeira transação que está sendo feita para usar o novo formato de token. Todas as transações subsequentes usarão o antigo padrão novamente, até começarmos o lançamento no dia 12 de junho.
Se surgirem quaisquer problemas após este teste, ofereceremos a você a opção de optar temporariamente por não participar da mudança. Enviaremos por e-mail um formulário referente à opção de sair em 6 de junho.
Resolução de Problemas
Caso seus sistemas tenham problemas inesperados em lidar com o novo formato de token, você pode gerenciar a transação (ex. cancelar/reembolsar/capturar) manualmente no seu Mollie Dashboard navegando até Pedidos/Pagamentos, selecionando a transação relevante e realizando a ação desejada lá.
Nota: Vamos realizar uma sessão de perguntas e respostas a 2 de junho no Discord. Adicionalmente, pode colocar quaisquer questões neste canal do Discord.
Cronogramas:
- 2 de junho: sessão de perguntas e respostas - Junte-se a nós no Discord
- 5 de junho: Transação de teste única por combinação única de perfil/user-agent/client_id
- 6 de junho: E-mail de acompanhamento, com a opção de optar temporariamente por não participar da mudança do novo token
- 12 de junho: Início do lançamento gradual do novo formato de token (excl. opt-outs)
- 8 de julho: 100% lançamento do novo formato de token (excl. opt-outs)
-
31 de dezembro: Fim do período de exclusão, migração de todos os perfis restantes.