Novos campos de pagamento e carrinho na listagem de pedidos

Anteriormente, integradores que demandavam o identificador único da transação financeira (pagamentos_id) eram obrigados a realizar consultas individuais e consecutivas no endpoint GET /transacao para cada pedido retornado. Na prática, consolidar uma lista de 100 pedidos exigia a execução de 100 requisições adicionais à API, gerando lentidão no processamento e expondo a integração a falhas por estouro de limite de requisições (rate limit). Além disso, o identificador do carrinho de origem (carrinhoId) não era disponibilizado nas listagens gerais.

Essa atualização resolve o gargalo de performance de ponta a ponta, unificando a entrega dessas informações chave em uma única chamada estruturada e reduzindo drasticamente o consumo de banda e infraestrutura de rede.

Os atributos pagamentos_id e carrinhoId passam a integrar de forma nativa as cargas de dados dos endpoints de pedidos:

• Endpoints Abrangidos: GET /pedidos (listagem geral) e GET /pedidos/{id} (consulta específica por ID).
• Parâmetro de Ativação: Para receber estes novos campos no retorno do JSON, basta incluí-los explicitamente através do parâmetro camposAdicionais na requisição.

Principais Benefícios para a Operação

• Otimização no Volume de Chamadas: Consolida o fluxo de dados em uma única requisição (1 chamada de listagem em vez de 1 chamada de lista + N chamadas de transação), mitigando riscos de gargalos e bloqueios por rate limit.
• Rastreabilidade de Origem: Disponibiliza o carrinhoId diretamente na listagem, simplificando as análises de conversão e permitindo identificar o carrinho gerador da compra sem requisições acessórias.
• Impacto Zero e Retrocompatibilidade: Por se tratar de um recurso baseado no modelo opt-in (via parâmetro camposAdicionais), a alteração não gera impactos de quebra de código ou modificações indesejadas para parceiros e integradores que optarem por não utilizar os novos campos.

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:

🔗 Campos na Listagem de Pedidos

Publicado em 20/07/2026