Códigos de Retorno da Adquirente no Endpoint de processamento do pagamento

Anteriormente, quando uma transação de pagamento era recusada pela adquirente, a plataforma recebia os códigos explicativos de retorno, mas não realizava a persistência dessas informações na base de dados. Consequentemente, a camada de front-end não tinha acesso aos detalhes da recusa, impossibilitando a exibição de uma justificativa clara ao consumidor final.

Para solucionar esse cenário, implementamos a persistência dos códigos de retorno das adquirentes no endpoint de processamento de pagamento. A partir de agora, esses dados ficam estruturados e acessíveis via API, permitindo que as equipes de desenvolvimento e agências parceiras personalizem as mensagens de erro no checkout.

Como funciona?

O código de retorno enviado pela adquirente passa a ser armazenado e disponibilizado diretamente na API Storefront. Com o acesso a esse parâmetro, as aplicações de front-end e agências parceiras podem mapear as causas de não aprovação (como saldo insuficiente, dados incorretos ou suspeita de fraude) e exibir orientações específicas e amigáveis para o cliente no momento da compra.

Principais Benefícios:

• Melhor Experiência de Compra: O consumidor final recebe uma explicação clara sobre o motivo da recusa do pagamento, reduzindo o abandono de carrinho por falta de orientação sobre como proceder.
• Maior Controle para Agências e Front-ends: Flexibilidade para customizar a comunicação no checkout com base nos códigos oficiais retornados pelas adquirentes.
• Menos Dependência da Plataforma: As agências e desenvolvedores ganham autonomia para tratar e exibir as mensagens de erro sem a necessidade de intervenções diretas no gateway.

Ainda sobrou alguma dúvida ou quer entender todos os detalhes de configuração e começar a aplicar agora mesmo? Confira o passo a passo completo na nossa documentação oficial:

🔗 Informações de Pagamento de Cartão no Checkout
🔗 Validação Checkout Online

Publicado em 24/08/2026