---
title: "Geração do hash e do código numérico"
method: POST
path: "/totp"
tags: ["Validação TOTP"]
---

# Geração do hash e do código numérico

`POST /totp`

Para mais informações, confira a documentação [Geração do <i>hash</i> e do código numérico](/docs/totp-geracao-de-hash).

## Headers

- `api-version` string, required
- `Authorization` string, required — <i>Token</i> de autorização do tipo Bearer.
- `x-bkly-user-id` string, required

## Request body

- CreateTotpRequest
  - `userId` string, nullable
  - `context` 'Pix', required — Contexto de uso do TOTP.
  - `operation` 'Portability' | 'Ownership' | 'RegisterEntry', required — Finalidade da geração do TOTP.
  - `data` object, required — Campo dinâmico para que o parceiro insira as informações necessárias a serem enviadas, de acordo com a operação (<code>operation</code>).
    - `addressingKey` object — Objeto que deverá conter os dados da chave de endereçamento. Este objeto <b>somente</b> deverá ser enviado caso o tipo de operação (<code>operation</code>) seja "RegisterEntry".
      - `type` 'PHONE' | 'EMAIL' — Tipo da chave de endereçamento.
      - `value` string — Número do telefone ou endereço do <i>e-mail</i>.
    - `claimId` string — Informe o valor retornado ao requisitar a portabilidade de uma chave ou reivindicar sua posse. Este campo <b>somente</b> deverá ser enviado caso o tipo de operação (<code>operation</code>) seja "Portability" ou "Ownership".

## Response `201`

Código criado com sucesso.

- CreateTotpResponse
  - `hash` string, nullable — Código criptografado que o parceiro deverá armazenar para posterior validação.
  - `code` string, nullable — Código numérico que o parceiro deverá enviar a seu cliente.

## Other responses

- `400` — Há algum problema com a sua requisição.
- `500` — Ocorreu algum erro inexperado em nosso servidor.
- `503` — O serviço está temporariamente indisponível.

---

[API](https://skmtc.net/bankly/apis/autentica-o.md) · [All operations](https://skmtc.net/bankly/apis/autentica-o/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bankly/autentica-o/versions/e20afa10cd0e/schema)