Skip to main content
Este evento é publicado quando o pagamento de uma fatura é processado com sucesso. Ele confirma que a organização cumpriu uma obrigação de pagamento — seja para uma assinatura de plano fixo ou para taxas acumuladas baseadas em uso. Este é um dos eventos de faturamento mais importantes porque sinaliza a coleta bem-sucedida de receita. Consumidores downstream normalmente o utilizam para ativar ou renovar assinaturas, atualizar dashboards de faturamento, gerar recibos e limpar quaisquer flags de inadimplência.
O campo type no payload distingue entre faturas PLAN (cobranças fixas de assinatura) e faturas FEE (cobranças variáveis de uso). O paymentMethod indica se o pagamento foi feito via CARD ou BOLETO, com o objeto de detalhes correspondente preenchido.
Ao tratar este evento, verifique se a organização tinha uma assinatura PAST_DUE. Um pagamento de fatura bem-sucedido frequentemente dispara um evento subscription.reactivated logo em seguida — mas não assuma que isso acontecerá. Use o invoiceId como sua chave de idempotência para prevenir geração duplicada de recibos ou aplicação dupla de créditos.

​
Detalhes do Evento

PropriedadeValor
Typeinvoice.paid

​
Schema do Payload

​
invoiceId
string (UUID v7)
required
Identificador da fatura.
​
organizationId
string (UUID v7)
required
FK para Organization.
​
subscriptionId
string (UUID v7)
FK para Subscription.
​
externalRef
string
required
Referência externa da fatura.
​
type
string
required
Tipo da fatura: PLAN ou FEE.
​
paymentMethod
string
required
Método de pagamento: CARD ou BOLETO.
​
card
object
Detalhes do cartão: {brand, last4, expMonth, expYear}.
​
boleto
object
Detalhes do boleto: {url}.
​
currency
string
required
Código da moeda (USD, BRL, EUR).
​
totalAmount
integer
required
Total em centavos.
​
discountAmount
integer
required
Desconto em centavos.
​
payableAmount
integer
required
Valor a pagar em centavos.
​
discounts
array
required
Descontos aplicados.
​
lines
array
required
Itens da fatura.
​
status
string
required
Status da fatura.
​
issuedAt
string (ISO 8601)
required
Data de emissão.
​
dueDate
string (ISO 8601)
required
Data de vencimento.
​
paidAt
string (ISO 8601)
required
Timestamp do pagamento.
​
createdAt
string (ISO 8601)
required
Timestamp de criação.
​
updatedAt
string (ISO 8601)
required
Timestamp da última atualização.
{
  "specversion": "1.0",
  "type": "invoice.paid",
  "id": "evt_0195f3a2-8c00-7d4e-b803-3c4d5e6f7a8b",
  "time": "2026-03-25T14:00:00Z",
  "datacontenttype": "application/json",
  "data": {
    "invoiceId": "0195f3a2-8c00-7d4e-b803-3c4d5e6f7a8b",
    "organizationId": "0195f3a2-8c00-7d4e-b801-1a2b3c4d5e6f",
    "subscriptionId": "0195f3a2-8c00-7d4e-b802-2b3c4d5e6f7a",
    "externalRef": "in_abc123",
    "type": "PLAN",
    "paymentMethod": "CARD",
    "card": {
      "brand": "visa",
      "last4": "4242",
      "expMonth": 12,
      "expYear": 2027
    },
    "boleto": null,
    "currency": "BRL",
    "totalAmount": 4900,
    "discountAmount": 0,
    "payableAmount": 4900,
    "discounts": [],
    "lines": [
      {
        "description": "Pro Plan — Monthly",
        "quantity": 1,
        "unitAmount": 4900,
        "amount": 4900
      }
    ],
    "status": "PAID",
    "issuedAt": "2026-03-01T00:00:00Z",
    "dueDate": "2026-03-10T00:00:00Z",
    "paidAt": "2026-03-25T14:00:00Z",
    "createdAt": "2026-03-01T00:00:00Z",
    "updatedAt": "2026-03-25T14:00:00Z"
  }
}