Pular para o conteúdo principal

API de pagamentos multi-status

Novidades​

A partir de 30/11/2026, a API de pagamentos passa a responder 207 Multi-Status quando uma chamada de pagamentos, sem batchId, contém pagamentos com status divergentes. Por exemplo, um pagamento que resulta em 400 e outro que resulta em 201 na mesma chamada.

Nesse caso, a resposta passa a informar o status code de cada pagamento inserido na chamada.

O que não muda​

  • O limite de 20 pagamentos por chamada continua o mesmo. A resposta 207 não o altera.
  • Todos os demais aspectos da API de pagamentos permanecem como estão, incluindo listagem, webhooks e cancelamento.

Como testar antes de 30/11​

O novo comportamento já pode ser testado enviando o header api-version com o valor 2026-05-18:

api-version: 2026-05-18

O que fazer na sua integração​

Se a sua integração trata apenas respostas 201 e 400 nas chamadas de pagamentos sem batchId, passe a tratar também o 207 e a ler o status code de cada pagamento na resposta.