---
title: "Solicitação de novo token"
method: POST
path: "/customers/{documentNumber}/biometry-token"
tags: ["Token de autenticação de identidade"]
---

# Solicitação de novo token

`POST /customers/{documentNumber}/biometry-token`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/customers/{documentNumber}/biometry-token`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Solicite um novo <i>token</i> de autenticação de identidade para o seu cliente.</p>
  <span class="bkly-ref-small-beta-tag">beta</span> 
  <span class="bkly-ref-scope-tag">scope: security.id-token.create</span>
</div>  
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Para mais informações, confira as documentações [Token de autenticação de identidade](/docs/token-autenticacao-identidade) e [Solicitação de novo token](/docs/solicitacao-novo-token)."
}
[/block]

## Headers

- `x-bkly-correlation-id` string, required

## Parameters

- `#/paths/~1devices/put/parameters/0` (unresolved $ref)
- `#/paths/~1devices/put/parameters/1` (unresolved $ref)
- `#/paths/~1document-analysis~1{documentNumber}/get/parameters/0` (unresolved $ref)

## Request body

- IdToken
  - `challenge` string, string, required: Tipo de desafio. Para a validação de um dispositivo, esse campo deve apresentar o valor "DEVICE_VERIFICATION”.
  - `claims` Claims, required: Objeto que contém informações sobre as <i>claims</i> (declarações adicionadas ao <i>token</i> para fornecer dados complementares sobre o contexto ou sobre as permissões associadas ao <i>token</i>).
    - `deviceHash` string, string, required: <i>Hash</i> do dispositivo, retornado no endpoint de registro de novo dispositivo móvel.
  - `ttl` integer: Tempo de vida do <i>token</i>, que é de, no máximo, 900 segundos.
  - `provider` string, string, required: Nome do provedor, que, nesse caso, é UNICO_CHECK.
  - `providerMetadata` ProviderMetaDataIdToken, required: <i>Token</i> JWT da imagem criptografada gerado dentro do aplicativo do parceiro no momento da captura da <i>selfie</i>. A imagem não deve ultrapassar 4 MB.
    - `encrypted` string, string, required: Tempo de vida do <i>token</i>, que é de, no máximo, 900 segundos.

## Response `200`

Recurso criado com sucesso.

- ResponseIdToken
  - `IdToken` string, uuid: GUID do <i>token</i> gerado.
  - `expiresIn` integer: Tempo de vida do to<i>token</i>ken, que é de, no máximo, 900 segundos.

## Other responses

- `400` (unresolved $ref)
- `422` (unresolved $ref)

---

[API](https://skmtc.dev/bankly/apis/id-one.md) - [All operations](https://skmtc.dev/bankly/apis/id-one/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/id-one/revisions/7cda227a76f4?raw)