External Transaction ID

O que é o externalTransactionId?

O externalTransactionId é um código de rastreamento único que criamos para cada transação feita por um cliente. Pense nele como o número de protocolo da sua solicitação.

A principal função desse código é garantir que todas as etapas e eventos de uma mesma transação sejam agrupados. Isso nos permite entender o histórico completo daquela operação, do início ao fim.

Por que o externalTransactionId é tão importante?

Este código de rastreamento oferece vários benefícios essenciais:

1. Rastreamento e Auditoria Completa

• Ele nos permite rastrear cada passo da transação. Por exemplo, se uma verificação de vivacidade (liveness) falhou, o externalTransactionId nos mostra exatamente qual tentativa foi, qual foi o resultado, e o que aconteceu em seguida. Isso cria um registro claro e detalhado de todas as atividades.

2. Resolução Rápida de Problemas

• Em caso de qualquer falha ou imprevisto, o externalTransactionId age como um guia. Ele nos ajuda a unificar e agrupar todas as tentativas e eventos associados a uma única solicitação. Com isso, nossa equipe de suporte pode investigar e resolver o problema de forma muito mais rápida e precisa, sem a necessidade de buscar informações em diferentes lugares.

3. Conexão entre Diferentes Sistemas

• Este identificador é criado e utilizado pelos seus próprios sistemas. Isso permite que a nossa plataforma e a sua se comuniquem perfeitamente. O externalTransactionId é a "chave" que conecta sua solicitação nos seus sistemas com a sua execução em nossa plataforma.

4. Segurança e Confiança

• Ao manter um registro detalhado e imutável de cada transação, o externalTransactionId ajuda a fortalecer a segurança e a conformidade. Ele é uma ferramenta vital para garantir que cada processo seja feito de forma segura e que possamos auditá-lo a qualquer momento.

Entendendo o fluxo de retentativa:

1. Início da Transação

• O cliente inicia uma transação.

2. Geração do externalTransactionId

• Ao tentar confirmar a transação, o aplicativo gera um externalTransactionId — um identificador único para essa tentativa de transação.
• Em seguida, o aplicativo faz a primeira solicitação para a plataforma Fortface, pedindo uma sessionId para a verificação facial, utilizando o externalTransactionId como referência.

3. Verificação Facial (Primeira Tentativa)

• O cliente é redirecionado para a tela de verificação biométrica.
• O SDK da Fortface é acionado, e o cliente realiza o reconhecimento facial.

4. Resultado da Verificação

• Cenário de Sucesso: Se o reconhecimento facial for bem-sucedido, o processo é concluído e a transação é finalizada. O cliente recebe a confirmação de sucesso.
• Cenário de Falha: Se o reconhecimento falhar (por exemplo, "Rosto não reconhecido"), o cliente é notificado do erro e tem a opção de "Tentar Novamente".

5. Retentativa (Usando o Mesmo externalTransactionId)

• Ao clicar em "Tentar Novamente", o aplicativo não inicia uma nova transação.
• Ele faz uma nova solicitação para o Fortface para uma sessionId (uma nova sessão para a verificação), mas desta vez, ele reutiliza o mesmo externalTransactionId da primeira tentativa.

O que isso significa?

Reutilizar o externalTransactionId permite que a plataforma Fortface e o aplicativo cliente agrupem todas as tentativas de verificação facial sob um único evento de transação.

• Para o cliente: A experiência é fluida e ele não precisa reiniciar o processo do zero.
• Para o suporte técnico e auditoria: É possível rastrear e analisar facilmente todas as tentativas de verificação biométrica para aquela transação específica, o que facilita a investigação e a resolução de problemas.

Exemplo de requisição com externalTransactionId

curl --request POST \ --url https://api-sandbox.fortface.ai/handshake \ --header 'Content-Type: application/json' \ --header 'x-api-key: string' \ --data '{ "galleryId": "string", "accountName": "string", "action": "enroll", "deviceRequestInfo": "string", "externaltransactionid": "string" }'