post
https://api.autra.io/v1/banking/accounts//pix-keys/claims
Inicia uma portabilidade (a chave está em outro PSP e o cliente quer
trazê-la para a Autra) ou reivindicação (apenas para telefone).
Tipos de chave aceitos (keyType):
national_registration— CPF/CNPJ. Só aceitaclaimType: PORTABILITY.email— só aceitaclaimType: PORTABILITY.phone_number— aceitaPORTABILITYouKEY_TRANSFER.
Chave aleatória (EVP) não é portável.
deviceId é obrigatório (BACEN Resolução 491) — use um device
autorizado da conta. Tela típica do app: depois do scan da chave/dado
em outro banco, antes de confirmar a portabilidade, captura o device id
e envia neste POST.
Fluxo
- Cliente solicita → este endpoint cria a
claimno DICT da Autra/Autra. - PSP atual da chave (doador) recebe a notificação e tem 7 dias
para confirmar/contestar. O cliente normalmente confirma no app do
PSP doador (tela tipo "autorizar portabilidade de chave Pix sainte"). - Quando o status mudar (
COMPLETED,DENIED, etc.), a Autra dispara
o webhook outboundpix_keys.claim.{completed|denied|confirmed}
pro BFF do tenant. ConsultarGET /pix-keys/claimstambém devolve
o status atual (fonte de verdade = DICT/Autra).
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
400Validação falhou (keyType inválido, key vazia, deviceId ausente etc.).
401Token ausente ou inválido.
404Conta não encontrada para este tenant.
