Regras e prazos

Status possíveis

Todo alerta nasce com status pending e evolui conforme a resposta do cliente ou o passar do tempo.

Status que você pode enviar via callback

Status	Quando usar
`notfound`	A transação não foi encontrada no seu sistema
`account_suspended`	A transação foi encontrada e já está resolvida (ex: conta suspensa, reembolso feito)
`other`	A transação foi encontrada, mas ainda não está resolvida

Ver Atualizar status para detalhes do endpoint.

Status visíveis no payload do webhook

Além dos três acima que você envia, o status do alerta no webhook pode aparecer como:

Status	Significado
`pending`	Status inicial de todo alerta recebido
`expired`	Alerta Ethoca cujo prazo passou sem resposta

Prazos por provedor

O alerta chega pending

Você responde em até 24 horas

notfound definitivo
account_suspended definitivo
other pode virar account_suspended em até 6 dias

Ninguém responde em 24 horas

expired definitivo, a disputa segue e costuma virar chargeback

Alertas de Mastercard (Ethoca). Nos de Visa (Verifi RDR) o estorno já foi feito: não há prazo, qualquer status vale a qualquer momento e o alerta não expira.

Ethoca (Mastercard)

Prazo para responder: 24 horas a partir do recebimento.

Você deve enviar notfound, account_suspended ou other via callback dentro desse prazo
Se o prazo passar sem resposta, o alerta vira expired automaticamente. O Ethoca entende como inação e a disputa segue o caminho normal (geralmente vira chargeback).

Conversão other → account_suspended: até 6 dias

Se você enviou other inicialmente porque ainda estava investigando, pode depois atualizar para account_suspended em até 6 dias do alerta original
Essa é a única transição permitida após uma resposta inicial

Status definitivos não podem ser alterados:

notfound é definitivo
account_suspended é definitivo
expired é definitivo

Verifi RDR (Visa)

Sem prazo obrigatório.

O estorno já foi executado automaticamente pela adquirente antes mesmo do alerta chegar
O status que você envia serve apenas para organização interna no painel
Você pode enviar qualquer um dos três status (notfound, account_suspended, other) a qualquer momento

Expiração

A Rapid marca alertas Ethoca como expired automaticamente após 24h sem resposta. Alertas Verifi RDR não expiram: ficam disponíveis no painel indefinidamente.

Reenvio

Em caso de falha de entrega do webhook, a Rapid faz até 4 tentativas (1 inicial + 3 retentativas) com intervalos de 5, 15 e 30 minutos (ver Retries e logs). Se todas as tentativas falharem, o alerta continua disponível no painel e pode ser reenviado manualmente pela equipe da Rapid.

Alertas reenviados mantêm o mesmo alert_id, por isso sua aplicação precisa ser idempotente.