Omni-WardDevelopers

Verificação hospedada

Crie a sessão no servidor e entregue o link ao cliente.

1. Crie a sessão no backend

const session = await omni.sessions.create({
  workflowVersionId,
  processingPurpose: 'Abertura de conta',
  legalBasis: 'consent',
  redirectUrl: 'https://app.exemplo.com/fim',
});
// Entregue session.url ao navegador ou aplicativo.

2. Abra o link

import { launchVerification } from '@omni-ward/sdk-web';

launchVerification({ url: session.url, mode: 'popup', onClose: refreshFromBackend });

3. Leia o resultado no backend

const detail = await omni.sessions.get(session.id);
// detail.status: situação técnica. detail.outcome e detail.reviewState: decisão de negócio.

Regras de segurança

  • O link funciona uma vez e expira em 15 minutos. Para retomar, crie outro com POST /v1/sessions/{id}/link; o anterior deixa de valer.
  • A ordem das etapas é imposta pelo servidor.
  • Eventos do navegador nunca são prova de resultado. Use a API ou webhooks assinados.
  • As etapas derivam do workflow publicado, e capacidades sem provedor habilitado impedem a criação da sessão.
  • O app hospedado não aceita iframe; use popup, redirecionamento ou WebView.