Reenviar webhook de transação

curl --request POST \
  --url https://api.public.firebanking.com.br/api/resend-webhook/{transactionIdentifier} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://meu-servidor.com/webhooks/firebanking"
}
'

{
  "message": "Webhook resent successfully",
  "webhookLogId": 12345,
  "sentAt": "2024-01-15T10:30:00.000Z",
  "statusCode": 200
}

Webhooks

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.

POST

api

resend-webhook

{transactionIdentifier}

Reenviar webhook de transação

curl --request POST \
  --url https://api.public.firebanking.com.br/api/resend-webhook/{transactionIdentifier} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://meu-servidor.com/webhooks/firebanking"
}
'

{
  "message": "Webhook resent successfully",
  "webhookLogId": 12345,
  "sentAt": "2024-01-15T10:30:00.000Z",
  "statusCode": 200
}

Autorizações

Authorization

string

header

obrigatório

Enter JWT token

Parâmetros de caminho

transactionIdentifier

string

obrigatório

Identificador da transação. Aceita: id numérico, externalId (seu código de referência) ou endToEndId (e2eId do PIX)

Exemplo:

"abc123-def456-ghi789"

Corpo

application/json

url

string<uri>

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.

Exemplo:

"https://meu-servidor.com/webhooks/firebanking"

Resposta

Webhook reenviado com sucesso

message

string

obrigatório

Mensagem descritiva do resultado

Exemplo:

"Webhook resent successfully"

webhookLogId

number

ID do log de webhook gerado para auditoria

Exemplo:

12345

sentAt

string

Data/hora do envio do webhook (ISO 8601)

Exemplo:

"2024-01-15T10:30:00.000Z"

statusCode

number

Código de status HTTP retornado pela URL de destino

Exemplo:

200

Configurar webhook da conta