Falha no pagamento de parcelas

Categoria: Cobrança
Evento: Falha no pagamento de parcelas

Nome do Evento

INSTALLMENT_PAYMENT_FAILED

Disparado em caso de erro na liquidação bancária assíncrona ou rejeição na conciliação de uma cobrança Pix.

Estrutura do Payload

{
  "eventType": "INSTALLMENT_PAYMENT_FAILED",
  "entityId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "occurredAt": "2026-09-28T16:15:00Z",
  "data": {
    "externalContractId": "CONTRATO-2026-001",
    "installmentNumber": 2,
    "billingExternalId": "bill-e4f5a6b7-c8d9-0123-ef45-678901234567",
    "attemptedAmount": 500.00,
    "reason": "PIX_TRANSACTION_REJECTED",
    "errorMessage": "Transação rejeitada pela instituição financeira de liquidação.",
    "failedAt": "2026-09-28T16:15:00Z"
  }
}

Tabela de Descrição dos Campos

Campo	Tipo	Descrição
`externalContractId`	string	Identificador do contrato no parceiro.
`installmentNumber`	integer	Número da parcela cuja tentativa de pagamento falhou.
`billingExternalId`	string	Identificador do título de cobrança Pix associado à tentativa com erro.
`attemptedAmount`	decimal	Valor financeiro da tentativa com falha.
`reason`	string	Código padronizado do motivo da falha.
`errorMessage`	string	Descrição detalhada do erro para suporte e auditoria.
`failedAt`	datetime	Data e hora em que a falha foi registrada (UTC).