Atualização da doc #43 - 05/11/2024 a 02/12/2024

Olá! Confira as atualizações da documentação ocorridas no mês passado! 😉

🆕O que há de novo

• Autorização: novos motivos para transação negada
• Novos campos no evento TRANSACTION_WAS_PROCESSED
• Fatura: novos tipos de transação (transactionType)
• Fatura: novos campos no evento INVOICE_REFINANCING_RATES_WAS_UPDATED
• Novos campos em eventos e em endpoint de fatura
• Novo evento de autorização

🚀Alterações e melhorias

• Acréscimo de informação em eventos de contas

🚧Problemas resolvidos

• Exclusão de campo em consulta de cartões

🆕 O que há de novo

Autorização: novos motivos para transação negada

Na documentação dos eventos do contexto de Autorização e confirmação, adicionamos dois novos motivos para que uma transação seja negada:

• ANTI_FRAUD_GENERIC_ERROR
• ANTI_FRAUD_TIEMOUT

Tais motivos são retornados no campo deniedRules dos eventos TRANSACTION_WAS_PROCESSED e NETWORK_VALIDATION_WAS_PROCESSED.

Novos campos no evento TRANSACTION_WAS_PROCESSED

Agora, o evento TRANSACTION_WAS_PROCESSED traz os seguintes novos campos:

• channel.passwordPresent: campo do tipo boolean que indica se a senha do cartão foi informada na autorização;
• card.programId: campo do tipo string que traz o identificador do programa ao qual o cartão pertence.

Fatura: novos tipos de transação (transactionType)

Acrescentamos novos tipos de transação na tabela Tipos de transações contida nas documentações Eventos de fatura, Consulta de fatura aberta e Consulta de fatura por ID. Confira!

Fatura: novos campos no evento INVOICE_REFINANCING_RATES_WAS_UPDATED

Na documentação Eventos de fatura, adicionamos novos campos na tabela e no payload referentes ao evento INVOICE_REFINANCING_RATES_WAS_UPDATED: monthlyCetRate e annualCetRate.

Novos campos em eventos e em endpoint de fatura

Nas documentações Consulta de fatura por ID (v2) e Eventos de fatura (v1), adicionamos o objeto exchangefee e mais três propriedades no objeto transaction: merchantCity, merchantStateOrCountry e merchantZipCode.

Confira os links das documentações atualizadas:

• Consulta de fatura por ID (versão 2.0):
  • Manual do Dev;
  • APIs.
• Eventos de fatura (versão 1.0):
  • TRANSACTION_CREATED
  • TRANSACTION_UPDATED
  • INVOICE_CLOSED_TRANSACTION_DETAILS_WAS_CREATED

Novo evento de autorização

Na documentação de eventos de autorização, adicionamos um novo evento chamado NETWORK_VALIDATION_WAS_PROCESSED, que tem por finalidade informar o resultado da validação acatado pela rede de cartões foi processado, indicando a aprovação ou reprovação da transação de débito pela bandeira.

🚀Alterações e melhorias

Acréscimo de informação em eventos de contas

Na documentação dos eventos ACCOUNT_WAS_CLOSED e ACCOUNT_WAS_LEGALLY_CLOSED informamos que o campo account.specialType também poderá retornar o valor “PAYMENT_ACCOUNT”, em caso de encerramento de conta cuja criação tenha sido anterior a 15/02/2023.

🚧Problemas resolvidos

Exclusão de campo em consulta de cartões

Retiramos o campo functionalities[].program.name dos responses das documentações referentes à consulta de cartões, pois esse parâmetro não é retornado nesses casos.

Atenciosamente,

Time de Tech Writers