Eventos de Fatura - 4SeletPay

invoice.created

Disparado quando uma nova fatura de assinatura é gerada. Ocorre automaticamente a cada ciclo da assinatura.

Payload

{
  "type": "invoice.created",
  "id": "hook_f6a1b2c3d4e5",
  "webhook_version": "v1",
  "data": {
    "code": "ord_invoice123",
    "status": "Pending",
    "value": 99.90,
    "payment_type": "CreditCard",
    "subscription_code": "sub_abc123xyz",
    "due_date": "2026-06-01T00:00:00.000000Z",
    "created_at": "2026-05-27T00:00:00.000000Z"
  }
}

Campo	Tipo	Descrição
`code`	string	Código único do pedido desta fatura
`status`	string	Status inicial (`Pending` ou `Approved`)
`value`	decimal	Valor da fatura em reais
`payment_type`	string	Método de pagamento da assinatura
`subscription_code`	string	Código da assinatura relacionada
`due_date`	string	Data de vencimento da fatura (ISO 8601)
`created_at`	string	Data de geração da fatura (ISO 8601)

invoice.failed

Disparado quando a tentativa de cobrança de uma fatura de assinatura falha — normalmente por recusa do cartão ou saldo insuficiente.

Payload

{
  "type": "invoice.failed",
  "id": "hook_a1b2c3d4e5f6",
  "webhook_version": "v1",
  "data": {
    "code": "ord_invoice456",
    "status": "Failed",
    "value": 99.90,
    "payment_type": "CreditCard",
    "subscription_code": "sub_abc123xyz",
    "failure_reason": "card_declined",
    "failed_at": "2026-05-27T10:00:00.000000Z"
  }
}

Campo	Tipo	Descrição
`code`	string	Código único do pedido desta fatura
`status`	string	Sempre `Failed`
`value`	decimal	Valor da fatura em reais
`payment_type`	string	Método de pagamento da assinatura
`subscription_code`	string	Código da assinatura relacionada
`failure_reason`	string	Motivo da falha retornado pelo gateway
`failed_at`	string	Data/hora da falha (ISO 8601)

Após uma falha de fatura, a assinatura pode entrar no status RecurringOverdue. Use o endpoint Quitar fatura em atraso para permitir que o cliente regularize manualmente.