Saltar para o conteúdo principal
GET
Obter escalonamento
A autenticação é uma novidade. Estes endpoints são servidos pelo emissor da sua aplicação, como https://<name>.auth.didit.me, e nunca aceitam a sua chave de API da Didit.
Um step-up pertence à sessão que o criou: o token de acesso de outra sessão recebe 404. Um step-up com estado pending passa a expired ao fim de 30 minutos.

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

step_up_id
string<uuid>
obrigatório

O id de POST /step-up/, 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 pela qual a pessoa tem de passar antes da ação.

id
string<uuid>
obrigatório
Exemplo:

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

rule
enum<string>
obrigatório

A regra que o solicitou. Quando se aplicam várias, a que tiver 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á possui) ou full_id (documento e selfie). Quando a Didit ainda não possui nenhum rosto da pessoa, selfie torna-se full_id assim que esta abre o verification_url.

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

"selfie"

status
enum<string>
obrigatório

Atue apenas sobre approved. review aguarda a revisão da sua equipa. declined não é definitivo enquanto verification_url estiver funcional: a pessoa pode tentar novamente e a verificação adicional regressa a pending. superseded significa que outra verificação assumiu o controlo da mesma, ou que o resultado não era para esta verificação adicional: crie uma nova.

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

"pending"

level
enum<string> | null
obrigatório

O nível que a verificação atingiu, após ser aprovada.

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

null

amount
string | null
obrigatório

O montante 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. A leitura de uma verificação adicional recolhe primeiro qualquer resultado a que a respetiva verificação tenha chegado, pelo que ainda pode devolver approved, review ou declined após este período; uma que ainda esteja pending devolve expired.

Exemplo:

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

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