Pular para o conteúdo principal
GET
Obter um step-up
A autenticação é nova. Esses endpoints são servidos pelo emissor da sua aplicação, como https://<name>.auth.didit.me, e não aceitam sua chave de API da Didit.
Um step-up pertence à sessão que o criou: requisições com o token de acesso de outra sessão retornam 404. Um step-up pending passa a aparecer como expired depois que seus 30 minutos se esgotam.

Autorizações

Authorization
string
header
obrigatório

O token de acesso da pessoa obtido em POST /token/: um JWT ES256 com o cabeçalho typ: at+jwt, válido por no máximo 5 minutos. Não é a sua chave de API da Didit.

Parâmetros de caminho

step_up_id
string<uuid>
obrigatório

O id retornado por POST /step-up/, que também é o parâmetro de consulta step_up no seu return_to. Um valor que não seja um UUID recebe uma página 404, não JSON.

Resposta

O step-up.

Uma verificação na qual a pessoa precisa ser aprovada antes da ação.

id
string<uuid>
obrigatório
Exemplo:

"94efc2c3-ca84-42fe-900b-6fb61669a7a1"

rule
enum<string>
obrigatório

A regra que a exigiu. Quando várias se aplicam, aquela com o método mais forte.

Opções disponíveis:
payout,
device,
bank,
contact
Exemplo:

"payout"

method
enum<string>
obrigatório

O que a pessoa faz: liveness, selfie (prova de vida comparada com o rosto que a Didit já tem) ou full_id (documento e selfie). Quando a Didit ainda não tem nenhum rosto da pessoa, selfie passa a ser full_id assim que ela abre verification_url.

Opções disponíveis:
liveness,
selfie,
full_id
Exemplo:

"selfie"

status
enum<string>
obrigatório

Aja somente em caso de approved. review aguarda a revisão da sua equipe. declined não é definitivo enquanto verification_url funcionar: a pessoa pode tentar novamente, e o step-up volta para pending. superseded significa que outra verificação assumiu a verificação dele, ou que o resultado não era para este step-up: crie um novo.

Opções disponíveis:
pending,
review,
approved,
declined,
expired,
superseded
Exemplo:

"pending"

level
enum<string> | null
obrigatório

O nível alcançado pela verificação, depois de aprovada.

Opções disponíveis:
liveness,
liveness_face_match,
full_id,
null
Exemplo:

null

amount
string | null
obrigatório

O valor do pagamento, com duas casas decimais.

Exemplo:

"900.00"

currency
string | null
obrigatório
Exemplo:

"USD"

created_at
string<date-time>
obrigatório
Exemplo:

"2026-10-17T10:41:14.894632Z"

completed_at
string<date-time> | null
obrigatório
Exemplo:

null

expires_at
string<date-time>
obrigatório

30 minutos após a criação. Ao ler um step-up, primeiro é coletado qualquer resultado que sua verificação tenha alcançado, então ele ainda pode retornar approved, review ou declined após esse prazo; um que ainda esteja pending retorna expired.

Exemplo:

"2026-10-17T11:11:14.894581Z"

Última modificação em 1 de novembro de 2026