Saltar para o conteúdo principal
POST
A autenticação é nova. 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 Didit.
Os parâmetros de consulta step_up e status no seu return_to servem apenas para indicar à sua aplicação que deve verificar. Antes de agir, leia o step-up com Obter um step-up e continue apenas quando status for approved.

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.

Corpo

application/json

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

action
enum<string>
obrigatório

payout (um levantamento ou transferência), bank (adicionar ou alterar uma conta bancária) ou contact (alterar um e-mail ou número de telefone). Um levantamento também aplica a regra de novo dispositivo.

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

Onde a pessoa regressa após a verificação, com step_up=<id>&status=approved adicionado. Quando uma regra se aplica, deve ser um dos 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 montante, até duas casas decimais. Também é aceite um número em formato JSON.

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

"900.00"

currency
string

Código ISO 4217 de amount. A predefinição é a moeda da regra de pagamento; um pagamento noutra 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 7 de novembro de 2026