Skip to main content
DELETE
Cancelar Validação KYC

Resumo

Este endpoint permite cancelar uma validação KYC que está em status pending, in_progress ou in_review. Quando cancelada:
  • O status da validação muda para cancelled
  • A sessão do provedor é encerrada (o usuário não pode mais acessar a URL de verificação)
  • A validação é marcada como não atual (isCurrent: false)
  • Você pode criar uma nova validação para a mesma entidade depois
Esta ação não pode ser desfeita. O usuário precisará iniciar um novo processo de validação se ainda precisar verificar sua identidade.

Quando Usar Isto

  • Cancelamento solicitado pelo usuário: O cliente não quer mais completar a verificação
  • Dados incorretos: As informações da entidade foram inseridas incorretamente
  • Validação duplicada: A validação foi criada por engano
  • Necessidade de reiniciar o processo: Precisa começar do zero com uma nova sessão de verificação

Requisição

Endpoint

Parâmetros de Rota

string
required
O ID da validação a ser cancelada

Headers

Parâmetros do Body

string
required
Motivo para cancelar a validação (mínimo 5 caracteres)Tipo: string (comprimento mínimo: 5)Exemplo: "Usuário solicitou cancelar o processo de verificação"

Resposta

Resposta de Sucesso (200 OK)

Retorna o objeto de validação atualizado com status cancelled:

Exemplo de Requisição

Respostas de Erro

Validação Não Encontrada (404)

Status Inválido (400)

A validação só pode ser cancelada se o status for pending, in_progress ou in_review:

Motivo Inválido (400)

O motivo deve ter pelo menos 5 caracteres:

Notas Importantes

Quando você cancela uma validação, tentamos excluir a sessão do provedor de KYC. A URL de verificação não funcionará mais para o usuário.
O motivo do cancelamento é salvo nos metadados da validação e nos registros de auditoria. Isso ajuda a manter a conformidade e rastrear por que as validações foram canceladas.
Você não pode cancelar validações que já estão approved, rejected, expired, abandoned ou cancelled. Apenas validações pending, in_progress ou in_review podem ser canceladas.
Após cancelar, você pode criar uma nova validação KYC para a mesma entidade. A validação anterior permanecerá no histórico com status cancelled.

Próximos Passos

Criar Validação KYC

Iniciar uma nova sessão de verificação

Consultar Status de Verificação

Consultar resultados de validação