> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firebanking.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Reenviar webhook de transação

> **Requer token Bearer no header Authorization**.

Reenvia o webhook de uma transação específica para a URL configurada ou para uma URL temporária (override).

O identificador da transação pode ser:
- **ID numérico da transação**: O ID retornado pela Fire Banking (campo `transactionId` nos webhooks)
- **Seu ID de referência**: O identificador que você forneceu ao criar a transação (externalId)
- **End-to-End ID do PIX**: O e2eId retornado nos webhooks (formato: E/D + 32 chars)

**Webhook por Tipo de Operação**:
- Cada tipo de operação (cash_in, cash_out, refund_in, refund_out) pode ter uma URL de webhook diferente
- O sistema identifica automaticamente o tipo da transação e busca a URL correspondente
- Se não houver webhook configurado para o tipo específico, retorna erro 400

**Comportamento de URL**:
- Se `url` for fornecido no body, usa essa URL temporariamente (não persiste)
- Se `url` não for fornecido, usa a URL configurada no webhook da conta para o tipo da operação
- Se nenhuma URL estiver disponível, retorna erro 400

**Rate Limiting**: 60 requisições por minuto por conta.



## OpenAPI

````yaml post /api/resend-webhook/{transactionIdentifier}
openapi: 3.0.0
info:
  title: Fire Banking Public API
  description: >-
    API Pública da Plataforma Fire Banking para integração com serviços de
    pagamento PIX e gestão de contas
  version: 0.1.0
  contact: {}
servers:
  - url: https://api.public.firebanking.com.br
    description: Servidor de produção
security: []
tags:
  - name: auth
    description: Endpoints de autenticação
  - name: Balance
    description: Endpoints de consulta de saldo
  - name: PIX
    description: Endpoints de transações PIX
  - name: Webhooks
    description: Endpoints de gerenciamento de webhooks
paths:
  /api/resend-webhook/{transactionIdentifier}:
    post:
      tags:
        - Webhooks
      summary: Reenviar webhook de transação
      description: >-
        **Requer token Bearer no header Authorization**.


        Reenvia o webhook de uma transação específica para a URL configurada ou
        para uma URL temporária (override).


        O identificador da transação pode ser:

        - **ID numérico da transação**: O ID retornado pela Fire Banking (campo
        `transactionId` nos webhooks)

        - **Seu ID de referência**: O identificador que você forneceu ao criar a
        transação (externalId)

        - **End-to-End ID do PIX**: O e2eId retornado nos webhooks (formato: E/D
        + 32 chars)


        **Webhook por Tipo de Operação**:

        - Cada tipo de operação (cash_in, cash_out, refund_in, refund_out) pode
        ter uma URL de webhook diferente

        - O sistema identifica automaticamente o tipo da transação e busca a URL
        correspondente

        - Se não houver webhook configurado para o tipo específico, retorna erro
        400


        **Comportamento de URL**:

        - Se `url` for fornecido no body, usa essa URL temporariamente (não
        persiste)

        - Se `url` não for fornecido, usa a URL configurada no webhook da conta
        para o tipo da operação

        - Se nenhuma URL estiver disponível, retorna erro 400


        **Rate Limiting**: 60 requisições por minuto por conta.
      operationId: WebhookResendController_resendWebhook
      parameters:
        - name: transactionIdentifier
          required: true
          in: path
          description: >-
            Identificador da transação. Aceita: id numérico, externalId (seu
            código de referência) ou endToEndId (e2eId do PIX)
          schema:
            type: string
            example: abc123-def456-ghi789
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResendWebhookInputDto'
      responses:
        '200':
          description: Webhook reenviado com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResendWebhookOutputDto'
        '400':
          description: >-
            Nenhuma URL de webhook disponível. Configure um webhook para o tipo
            de operação desta transação ou forneça uma URL temporária no campo
            'url'.
        '401':
          description: Token inválido, expirado ou não fornecido
        '404':
          description: Transação não encontrada ou não pertence à conta autenticada
        '429':
          description: Rate limit excedido (max 60 req/min)
      security:
        - bearer: []
components:
  schemas:
    ResendWebhookInputDto:
      type: object
      properties:
        url:
          type: string
          format: uri
          description: >-
            URL temporária para este reenvio específico. Se não fornecida, usa a
            URL configurada no webhook da conta. A URL não é persistida.
          example: https://meu-servidor.com/webhooks/firebanking
    ResendWebhookOutputDto:
      type: object
      required:
        - message
      properties:
        message:
          type: string
          description: Mensagem descritiva do resultado
          example: Webhook resent successfully
        webhookLogId:
          type: number
          description: ID do log de webhook gerado para auditoria
          example: 12345
        sentAt:
          type: string
          description: Data/hora do envio do webhook (ISO 8601)
          example: '2024-01-15T10:30:00.000Z'
        statusCode:
          type: number
          description: Código de status HTTP retornado pela URL de destino
          example: 200
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Enter JWT token

````