Pagamentos

Para um consolidado completo de todas mudanças da API, detalhes de prazo para conclusão dos ajustes e contatos de suporte, acesse a página Visão Geral das mudanças da API.

Resumo das mudanças em Pagamentos

Detalhes das mudanças

1. POST /core/v5/orders — Padrão ABECS no acquirer_return_code

• O que muda: o campo acquirer_return_code passa a seguir o padrão ABECS.
• Impacto: integrações que interpretam ou tratam códigos de retorno do adquirente precisam ser atualizadas para o novo padrão.
• Ação necessária: atualize o tratamento de códigos de retorno na sua integração para o padrão ABECS. Para mais detalhes acesse aqui

---

2. Reprocessamento de cobranças — Geração de novo charge_id

• O que muda: quando uma cobrança reprovada pelo antifraude é elegível para reprocessamento, o sistema passará a criar uma nova cobrança com um charge_id distinto. Antes, a nova tentativa era adicionada à mesma cobrança, mantendo o charge_id original.
• Impacto: A cobrança original permanece inalterada com seu status final (failed/cancelled) e o reprocessamento gera uma nova cobrança com seu próprio charge_id, ambas vinculadas ao mesmo order_id ou invoice_id. Integrações que acompanham o ciclo de vida de uma cobrança pelo charge_id serão afetadas nas três frentes abaixo.
  • Webhooks de atualização de status chegarão com o charge_id da nova cobrança, não com o original.
  • Consultas à API pelo charge_id original retornarão a cobrança com seu status final, sem refletir a nova tentativa;
  • Fluxos de conciliação que identificam tentativas de pagamento pelo charge_id precisarão reconhecer o novo registro como uma entrada independente.
• Ação necessária: utilize o order_id ou invoice_id como chave de busca para localizar todas as cobranças de um pedido, incluindo as geradas por reprocessamento. Atualize seus fluxos de webhook, consultas de API e conciliação para tratar o charge_id da nova cobrança corretamente, não como atualização da cobrança original, mas como um registro independente vinculado ao mesmo pedido.

---

3. Response transacional — Formato do Gateway_Id

• O que muda: os campos Charge.Gateway_Id e Transaction.Gateway_Id no response transacional já são string, mas atualmente são retornados com valores numéricos e passarão a ser alfanuméricos.
• Impacto: integrações que armazenam ou processam esses campos como tipo numérico (ex.: coluna INTEGER/BIGINT em banco de dados, parsing como int) serão impactadas.
• Ação necessária: valide se esses campos são tratados como string em sua integração. Caso não seja, ajuste o schema do banco de dados, tipagem e parsing para suportar valores alfanuméricos (string) com até 128 caracteres.

---

4. Cancelamento de boleto via TED

• O que muda: a funcionalidade de estorno de boletos via TED será descontinuada.
• Impacto: clientes que utilizam essa funcionalidade deixarão de poder realizar estornos de boletos por esse método.
• Ação necessária: revise os fluxos operacionais que dependem dessa funcionalidade.

---

Perguntas frequentes das mudanças em Pagamentos