PagnovoPagnovodocs

Referência da API

Reenviar notificação da fatura

Reenfileira uma notificação ao Customer da Invoice. O sistema cria um registro `InvoiceNotification` com status `PENDING` que o worker despacha em seguida. **Só funciona em Invoices com Customer associado** (invoices públicas sem customer não têm destinatário). O canal disponível hoje é **EMAIL** (o Customer precisa ter `email` preenchido); SMS e WhatsApp estão no roadmap.

POST/v2/invoices/:id/notifications/resend

Autenticação

HTTP Basic Auth. Envie sua secret key no header:

Authorization: Basic {base64(secret:SUA_SECRET_KEY)}

Parâmetros

idstring (path, UUID)obrigatório

UUID da Invoice.

Exemplo: inv_111aaa

Body da requisição

Content-Type: application/json

JSON
{
  "type": "INVOICE_REMINDER",
  "channel": "EMAIL"
}

Respostas

201

Notificação enfileirada. Status inicial PENDING. Será processada de forma assíncrona em seguida.

JSON
{
  "id": "notif_999",
  "invoiceId": "inv_111aaa",
  "type": "INVOICE_REMINDER",
  "channel": "EMAIL",
  "recipient": "joao@exemplo.com",
  "status": "PENDING",
  "createdAt": "2026-09-13T10:00:00.000Z"
}
400

Tipo ou canal inválido, Invoice pública (sem customer), ou Customer sem o campo necessário.

JSON
{
  "status": 400,
  "error": "type invalido. Aceitos: INVOICE_CREATED, INVOICE_REMINDER, INVOICE_OVERDUE, INVOICE_PAID, INVOICE_CANCELED"
}
404

Invoice não encontrada.

JSON
{ "status": 404, "error": "Invoice nao encontrada" }

Exemplos

cURL
curl -X POST "https://api.pagnovo.com/v2/invoices/inv_111aaa/notifications/resend" \
  -H "Authorization: Basic $(echo -n 'secret:SUA_SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{ "type": "INVOICE_REMINDER", "channel": "EMAIL" }'