Pular para o conteúdo principal

Reprovar um Lote de Transferência

PUT 
/v2/transfer/batches/:uid/reprove

Processamento Assíncrono: Este endpoint é processado assincronamente e cria um comando de reprovação para o Lote de Transferência. A resposta traz em data o comando de reprovação do lote. Esse comando é a autorização da reprovação: cada transferência apta (aguardando aprovação e com registro confirmado) é rejeitada separadamente na instituição financeira sob essa autorização. A reprovação também interrompe as liberações de transferências ainda pendentes. Você pode consultar o comando a qualquer momento pelo data.uid.

Idempotência​

Repetir a chamada enquanto a autorização estiver em pé (comando pending ou confirmed) e o lote ainda estiver aguardando aprovação responde 200 com o mesmo data.uid e rejeita apenas as transferências que ficaram aptas desde a chamada anterior. Um data.uid diferente só aparece quando a autorização anterior deixou de valer:

  • o lote foi aprovado antes da primeira rejeição (o comando anterior fica interrupted);
  • a instituição financeira recusou a rejeição de todas as transferências (o comando anterior fica failed).

A resposta 422 com Nenhuma transferência do lote está apta a ser reprovada. ocorre quando não há autorização em pé e nenhuma transferência do lote pôde ser enviada (nenhuma transferência do lote está apta ou o provedor financeiro não oferece a operação via API).

Reprovação não atômica​

Cada transferência é rejeitada separadamente. O comando vai a confirmed na primeira rejeição; o status do lote só vai a reproved quando todas as transferências forem rejeitadas. Se a instituição financeira recusar a rejeição de parte das transferências, o lote continua awaiting_approval. Acompanhe cada transferência pelo status dela.

Eventos de Webhook​

  • transfer.transfer_batch.reprove.requested: quando a requisição é realizada.
  • transfer.transfer_batch.reprove.confirmed: na primeira rejeição, com as demais transferências ainda em processamento.
  • transfer.transfer_batch.reprove.failed: quando a instituição financeira recusa a rejeição de todas as transferências.

⚠️ Atenção ao status Reprovado: O status de Reprovado é terminal. Quando a instituição financeira cancelar as transferências, as mesmas terão seus status alterados para Reprovado.

Request​

Responses​

Comando de reprovação do lote