Lançamento da v2.0.0-rc.1 da API Pagamentos automáticosDados do cliente – Orientações quanto ao uso do token de consentimentoDados do cliente – Atualização das informações sobre cenários para o retorno de permissions e scope na página “Orientações – [D...

Lançamento da v2.0.0-rc.1 da API Pagamentos automáticos

Informamos que a área do desenvolvedor do Portal do Open Finance Brasil foi atualizada, em 05/02/2025, com a documentação da versão release candidate da API Pagamentos automáticos (v2.0.0-rc.1).

Dentre as alterações, destacamos:

Alterações em consentimentos:

Remoção dos sinais de risco para revogação e rejeição de consentimentos via ITP;

Novos motivos e regras de rejeição (AUTENTICACAO_DIVERGENTE);

Ajustes às regras de edição de consentimentos (endpoint PATCH);

Ajuste ao prazo de permanência do estado PARTIALLY_ACCEPTED.

Alterações em pagamentos e transferências:

Correções ao objeto “/data/cancellation/cancelledBy”;

Novas regras para transferências entre mesma instituição.

Alterações na configuração recorrente:

Ajuste na obrigatoriedade de campos;

Alteração no campo de referência de início.

Tratamento de erros e cabeçalhos:

Ajustes ao erro DETALHE_PAGAMENTO_INVALIDO;

Adição de cabeçalhos para o x-fapi-interaction-id;

Novo cabeçalho (x-v);

Orientações sobre cancelamento de novas tentativas de pagamento.

Outras alterações:

Ajuste às regras de agendamento de novas tentativas;

Ajustes ao campo “/data/debtorAccount/ibgeTownCode”.

Para acessar todas as alterações, sugerimos consultar o changelog.

Como complemento, informamos que o motor de conformidade atualizado será disponibilizado em 15/02/2025 e terá alteração relevante em 6 módulos de teste, em que 4 serão obrigatórios para todas as instituições e 2 serão obrigatórios para instituições ofertantes de múltipla alçada:

Obrigatórios:

automatic-payments_api_automatic-pix-consent-edition-negative_test-module_v2;

automatic-payments_api_automatic-pix-consent-edition-restrictive_test-module_v2;

automatic-payments_api_automatic-pix-extraday-core_test-module_v2;

automatic-payments_api_automatic-pix-wrong-creditor_test-module_v2.

Condicionais (Múltiplas alçadas):

automatic-payments_api_multiple-consents-core_test-module_v2;

automatic-payments_api_webhook-multiple-consents_test-module_v2”.

Os demais marcos de certificação, período de piloto e go live se mantêm como descrito no Informa #661 (“Novo cronograma de implementação da v2.0.0 da API Pagamentos automáticos (Transferências inteligentes + Pix automático)”, enviado em 14/11/2024).

Para mais detalhes, sugerimos acessar os links de documentação abaixo:

Clique aqui para acessar a v2.0.0-rc.1 da API Pagamentos automáticos

Clique aqui para acessar o changelog entre as versões v2.0.0-rc.1 e v2.0.0-beta.2

Clique aqui para acessar os planos de testes no wiki do fornecedor

Clique aqui para acessar o Informa #661

Clique aqui para acessar a página de Calendários

Dados do cliente – Orientações quanto ao uso do token de consentimento

Informamos que, em 05/02/2025, a página “Orientações - [DC] Consentimentos” da área do desenvolvedor foi atualizada com as seguintes orientações quanto ao uso do token de consentimento da API Consentimento:

O estado e a validação do consentimento devem ser considerados antes do acionamento do token;

Após a identificação de que um consentimento está vencido/inativo, é indicado que não haja recorrência de acionamentos do token, que está inválido, para realização de consulta de informações e acesso aos serviços, a fim de evitar comportamentos de consumo inadequado das APIs.

Para mais detalhes, sugerimos acessar o link da documentação abaixo.

Clique aqui para acessar a página “Orientações - [DC] Consentimentos”

Dados do cliente – Atualização das informações sobre cenários para o retorno de permissions e scope na página “Orientações – [DC] Consentimentos”

Informamos que o capítulo “Regras para a criação do consentimento”, na página “Orientações – [DC] Consentimentos” da área do desenvolvedor, foi atualizado em 05/02/2025 com informações a respeito do comportamento esperado da instituição transmissora nos cenários em que o cliente não possui os produtos de contas e/ou cartões.

Para mais detalhes, sugerimos acessar o link da documentação abaixo.

Clique aqui para acessar a página “Orientações - [DC] Consentimentos”