Reenviar Webhook

POST/api/webhook/resend

Enfileira o reenvio assíncrono de um webhook de pagamento para a URL de callback previamente cadastrada na transação original.

Autenticação e Segurança

Tipo: Bearer Token JWT ([Authorize("Bearer")])

Cabeçalhos (Headers)

Cabeçalho	Valor	Obrigatório	Descrição
`Authorization`	`Bearer <token>`	Sim	Token JWT de autenticação
`Content-Type`	`application/json`	Sim	Tipo de conteúdo enviado

Parâmetros

Exemplo de requisição

{
  "paymentResultId": "PAY_9876543210"
}

Retorno (202)

Exemplo de resposta

{
  "paymentLinkId": "105432",
  "paymentResultId": "105432",
  "status": "queued"
}

Dicionário de dados

Erros

As respostas de erro conhecidas estão abaixo. Os retornos observados em homologação estão identificados separadamente dos exemplos documentados; as respostas podem variar conforme o ambiente e a configuração.

Observado em homologação

Requisição com corpo JSON vazio ou identificador sintético. O retorno abaixo mostra a validação realizada em homologação.

[
  {
    "tag": "PaymentResultId",
    "description": "O ID do resultado do pagamento é obrigatório."
  }
]

Exemplo documentado

PaymentResultId

O corpo da resposta deste código não está documentado; não há exemplo JSON disponível.

Campos da resposta de erro

A tabela reúne os campos presentes nos exemplos acima. Uma resposta HTTP sem corpo não inclui esses campos.

Cenários de Erro

Status HTTP	Tag	Descrição	Motivo / Regra de Negócio
`400 Bad Request`	`PaymentResultId`	`O ID do resultado do pagamento é obrigatório.`	Campo ausente ou vazio na requisição.
`400 Bad Request`	`PaymentResultId`	`O ID do resultado do pagamento deve ter no máximo 50 caracteres.`	Identificador excede o limite máximo de 50 caracteres.
`400 Bad Request`	`""`	`Webhook não encontrado.`	Registro não encontrado em `PaymentGatewayHistory` ou pertence a outra conta (`ContaNroConta`).
`401 Unauthorized`	`""`	`Não autorizado.`	Bearer Token ausente, inválido ou expirado.
`409 Conflict`	`urlCallBack`	`O webhook não possui URL de callback.`	O registro original da transação não possui `urlCallBack` configurada.
`409 Conflict`	`""`	`O webhook já foi processado com sucesso.`	A notificação já retornou `HTTP 200 OK` anteriormente (evita duplicidade).

Certifique-se de que o seu endpoint de destino esteja preparado para receber requisições POST e responda com status HTTP 200 OK assim que processar o evento.