Programação de descomissionamento da API v1 de DDA

Prezados clientes,

Gostaríamos de informar que, hoje estamos começando o processo de descomissionamento da API v1 de DDA em favor da API v2. O processo ocorrerá em três etapas:

1. No dia deste comunicado, serão adicionados os headers referentes ao nosso protocolo de descomissionamento na API de produção, conforme Descomissionamento de APIs.
2. No dia 20 de outubro de 2025, serão desligados permanentemente os endpoints referentes à API v1 de DDA no ambiente de sandbox.
3. No dia 20 de novembro de 2025, a API em produção será desligada permanentemente.

Endpoints afetados:

• https://api.sandbox.empresas.btgpactual.com/v1/companies/{companyId}/authorized-direct-debits
• https://api.sandbox.empresas.btgpactual.com/v1/companies/{companyId}/authorized-direct-debits/{authorizedDirectDebitId}/debits
• https://api.empresas.btgpactual.com/v1/companies/{companyId}/authorized-direct-debits
• https://api.empresas.btgpactual.com/v1/companies/{companyId}/authorized-direct-debits/{authorizedDirectDebitId}/debits

Orientações para a migração para a API v2 de DDA

Recomendamos que todas as integrações sejam migradas para a API v2 de DDA o quanto antes. A API v2 oferece melhorias significativas em termos de desempenho e funcionalidades adicionais que não estão presentes na versão anterior.

Para realizar a migração, será necessária a inclusão do novo escopo brn:btg:empresas:banking:direct-debit em seu aplicativo na Área do Desenvolvedor.

Os contratos da API v2 estão disponíveis a partir em DDA v2.

Os webhooks seguem inalterados e não sofrerão impacto com o descomissionamento da API v1 de DDA.