API Reference
  1. Autra Platform API
  2. Banking

Registrar device

post
https://api.autra.io/v1/banking/devices

Inicia o registro de um novo device. A Autra puxa nome / CPF / email / telefone do titular automaticamente da onboarding_proposals — você só precisa enviar o deviceId e metadata opcional.

Fluxo SMS (default — único permitido em produção)

  1. POST /v1/banking/devices (este endpoint) → device fica em WAITING_MFA
  2. Autra dispara SMS pro telefone do titular (registrado no onboarding)
  3. Frontend coleta o código de 6 dígitos
  4. POST /v1/banking/devices/{id}/mfa-confirm com {"code": "123456"} → device vira AUTHORIZED

Fluxo EXTERNAL

Para tenants com MFA próprio (biometria, app dedicado). Bloqueado em produção (depende de aprovação contratual da Autra). Tentativas retornam 422 EXTERNAL_MFA_NOT_APPROVED.

Pré-requisitos

  • O tenant precisa ter completado onboarding (status=COMPLETED) — a onboarding_proposals deve ter personal_data.full_name, cpf, email e phone preenchidos. Senão retorna 422 MISSING_PERSON_INFO.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Body para registrar um novo device. A Autra puxa nome/CPF/email/telefone do titular automaticamente da onboarding_proposals — você só precisa enviar o deviceId e metadata opcional do dispositivo.

⚠️ Fluxo EXTERNAL está bloqueado em produção (depende de aprovação contratual da Autra). Use sempre o flow SMS (default).

string
required

Identificador único do device (UUID do app, fingerprint do browser, IMEI). Não confundir com o id interno gerado pela Autra.

string

Hash de contexto do device (browser fingerprint).

string

Nome amigável pra UI.

string
string
string

IP origem da requisição (auditoria).

uuid

UUID Autra da conta. Opcional — se omitido, a Autra resolve via tenant atual (banking_accounts).

string
enum
Defaults to SMS

SMS (default e único permitido em produção). EXTERNAL é rejeitado com 422 EXTERNAL_MFA_NOT_APPROVED.

Allowed:
uuid

UUID do processo MFA externo. Obrigatório se authenticationMethod=EXTERNAL.

date-time

Data/hora do MFA externo (RFC3339). Obrigatório se authenticationMethod=EXTERNAL.

Responses

403

Token inválido.

Updated 11 days ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 11 days ago

Did this page help you?