Pular para o conteúdo principal
POST
A autenticação é um recurso novo. Esses endpoints são disponibilizados pelo emissor da sua aplicação, como https://<name>.auth.didit.me, e não aceitam a sua chave de API da Didit.
Os parâmetros de consulta step_up e status no seu return_to apenas indicam à sua aplicação que ela deve verificar. Antes de agir, consulte o step-up com Obter um step-up e só continue quando status for approved.

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.

Corpo

application/json

A ação sensível que a pessoa está prestes a realizar.

action
enum<string>
obrigatório

payout (um saque ou uma transferência), bank (inclusão ou alteração de uma conta bancária) ou contact (alteração de e-mail ou número de telefone). Um payout também aplica a regra de novo dispositivo.

Opções disponíveis:
payout,
bank,
contact
return_to
string
obrigatório

Para onde a pessoa retorna após a verificação, com step_up=<id>&status=approved adicionado. Quando uma regra se aplica, deve ser uma das URIs de redirecionamento da aplicação; quando nenhuma se aplica, não é verificado.

Maximum string length: 2048
Exemplo:

"https://app.example.com/payouts/confirm"

amount
string

Obrigatório para payout: o valor, com até duas casas decimais. Um número JSON também é aceito.

Pattern: ^[0-9]{1,16}(\.[0-9]{1,2})?$
Exemplo:

"900.00"

currency
string

Código ISO 4217 de amount. O padrão é a moeda da regra de pagamento; um pagamento em outra moeda é sempre verificado.

Pattern: ^[A-Z]{3}$
Exemplo:

"USD"

Resposta

Nenhuma regra se aplica.

Nenhuma regra se aplica: prossiga com a ação.

required
enum<boolean>
obrigatório
Opções disponíveis:
false
Última modificação em 1 de novembro de 2026