Pular para o conteúdo principal
Use um único mapa de status para produto, operação e suporte.

Status do recurso da API

StatusSignificadoAção típica
pendingaceito, mas ainda não finalmonitore
scheduledagendado para execução futuramantenha agendado
in_analysisrevisão manual ou do provedormantenha na fila e visível para operação
processingliquidação em andamentoaguarde webhook ou reconcilie
paidliquidado com sucessomarque o payout como concluído
rejectedbloqueado antes da liquidaçãoencaminhe para revisão operacional
cancelledinterrompido de forma intencionalencerre a solicitação
errorfalhou durante o processamentoinvestigue a política de retry
unknownainda não normalizadoreconcilie imediatamente

Mapeamento de eventos de webhook

Status do recurso e nomes de eventos de webhook não são idênticos.
  • payout.transferred mapeia para status de recurso paid
  • payout.failed mapeia para status de recurso error
  • payout.canceled mapeia para status de recurso cancelled

Por que isso importa

Se o seu produto mostrar nomes de evento como se fossem status de recurso, a operação fica ambígua. Mantenha um mapeamento interno único e reutilize-o em webhook, dashboard e reconciliação.

Leia a seguir