TrustSessions

Reenviar código OTP da sessão de confiança

Reenvia o desafio OTP para a Sessão de Confiança atual.

Limitado a um reenvio a cada 60 segundos por sessão. Dentro desse intervalo a chamada retorna 409 com o tempo restante — o endpoint é autenticado pelo signatário e cada envio custa um SMS.

Autenticação via embedToken (clientSecret).

post/v1/trust-sessions/{sessionId}/resend-otp

Request

  • Base URL: https://api.signdocs.com.br
  • URL: https://api.signdocs.com.br/v1/trust-sessions/{sessionId}/resend-otp
  • Auth: HTTP bearer

Path parameters

sessionIdstring required

Identificador único da sessão de confiança.

Response

OTP reenviado com sucesso.

sessionIdstring required
status'ACTIVE' | 'COMPLETED' | 'CANCELLED' | 'EXPIRED' | 'FAILED' required

Status da sessão de assinatura.

evidenceIdstring

ID da evidência (presente quando status é COMPLETED).

redirectUrlstring uri

URL de redirecionamento (returnUrl + session_id).

completedAtstring date-time

Data/hora de conclusão (quando status é COMPLETED).

hostedUrlstring uri

URL da página de liveness hospedada (para start_liveness).

livenessSessionIdstring

ID da sessão Rekognition (para start_liveness).

signatureRequestIdstring

ID da requisição de assinatura (para prepare_signing).

hashToSignstring

Hash a ser assinado pelo certificado (para prepare_signing).

hashAlgorithmstring

Algoritmo do hash (ex. SHA-256).

signatureAlgorithmstring

Algoritmo de assinatura esperado (ex. SHA256withRSA).

errorCodestring

Motivo da reprovação de uma etapa, quando ela falha sem que a requisição falhe. Esta é a parte que mais importa numa integração biométrica: uma etapa reprovada volta 200 com a sessão ainda ACTIVE e o motivo aqui — não como erro HTTP. Quem trata só o status HTTP lê uma reprovação como sucesso.

Valores emitidos hoje:

CódigoSignificado
BIOMETRIC_MATCH_FAILEDSimilaridade abaixo do limiar exigido
LIVENESS_NOT_COMPLETEDA captura de vivacidade não foi concluída
DOCUMENT_QUALITY_LOWBrilho ou nitidez abaixo do piso do tenant
DOCUMENT_MATCH_FAILEDA comparação com a foto do documento não foi aprovada
SERPRO_*Falha na consulta SERPRO — SERPRO_TIMEOUT, SERPRO_RATE_LIMITED, SERPRO_CIRCUIT_OPEN, SERPRO_AUTH_FAILURE, SERPRO_CREDENTIALS_ERROR, SERPRO_INVALID_REQUEST, SERPRO_SERVER_ERROR

CPF_REQUIRED e CPF_MISMATCH não aparecem aqui: são 400, com o código dentro do corpo do problema, não desta resposta 200.

errorDetailstring

Texto em pt-BR destinado ao signatário, pronto para ser exibido. Descreve o que fazer, não o que houve internamente.

retryableboolean

true enquanto restam tentativas na etapa. Quando as tentativas acabam a etapa vai a FAILED e este campo vem false — é o sinal de que insistir não adianta. Cada nova tentativa é cobrada como excedente.

Example response

{
  "sandbox": {
    "otpCode": "123456"
  },
  "errorCode": "BIOMETRIC_MATCH_FAILED",
  "errorDetail": "Não foi possível confirmar seu rosto. Tente novamente."
}

Changes

No recorded changes to this operation across all 1 revision of this API.