Criar Webhook

Cadastra URL para recebimento de webhooks com assinatura criptográfica HMAC SHA-256 no header X-NFER-Signature.

POSThttps://api.nfer.me/v1/webhooks

Chave de API (X-API-Key)

<sua_chave_api>

Headers da Requisição

X-API-Keystringobrigatório

Chave de API.

Corpo da Requisição (JSON Body)

urlstring<url>obrigatório

URL pública HTTPS do seu servidor.

Exemplo: https://meu-erp.com.br/api/nfer-webhook

eventosarray<string>obrigatório

Lista de eventos (ex.: ["nfe.*", "nfse.autorizada"]).

Exemplo: ["nfe.autorizada", "nfe.cancelada"]

Criar Webhook

curl --request POST \
  --url https://api.nfer.me/v1/webhooks \
  --header 'X-API-Key: <sua_chave_api>' \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "https://meu-erp.com.br/api/nfer-webhook",
  "eventos": [
    "nfe.autorizada",
    "nfe.cancelada"
  ]
}'

{
  "id": "wh_778899",
  "url": "https://meu-erp.com.br/api/nfer-webhook",
  "secret": "whsec_88a99b77c66d55e44f33",
  "message": "Webhook cadastrado. Salve o secret para validar as assinaturas HMAC recebidas."
}