Como criar uma chave Pix do tipo telefone (celular) no app da Juno para usar no gateway Juno do Quaza.
O que é a chave Pix de telefone
A chave Pix do tipo telefone usa o seu número de celular como identificador para receber transferências Pix. Para receber Pix dos seus clientes pelo gateway Juno do Quaza, é preciso ter uma chave Pix cadastrada na sua conta Juno — você cria essa chave no app da Juno e, depois, informa no Quaza.
O passo a passo é no app da Juno. A criação da chave acontece no aplicativo móvel da Juno; o Quaza só usa a chave já criada (informada na aba Gateway da carteira modelo).
Como funciona a criação
Você cria a chave no app, valida por SMS, e depois informa essa chave no Quaza:
Glossário
| Termo |
O que significa |
| Chave Pix |
Identificador para receber transferências Pix (CPF/CNPJ, e-mail, celular ou chave aleatória). |
| Chave de telefone |
Tipo de chave Pix que usa o número de celular cadastrado. |
| App Juno |
Aplicativo móvel da Juno onde a chave Pix é criada e gerenciada. |
| Gateway Juno |
Integração do Quaza com a Juno (configurada na aba Gateway da carteira modelo). |
| Token Juno |
Mecanismo do app Juno que valida ações sensíveis (criação da chave, por exemplo). |
Antes de começar
Você vai precisar de:
• Uma conta na Juno com o app instalado no celular.
• O número de telefone que você quer usar como chave (precisa estar ativo para receber o SMS).
Passo a passo (no app Juno)
1 Abra o app da Juno, vá em Pix e escolha Criar Chave Pix. Selecione a opção Celular.
Tela do app Juno: escolha o tipo de chave (use Celular).
2 Inclua o seu número de telefone com DDD e toque em Avançar.
Informe o número de celular completo (com DDD).
3 Digite o código de segurança recebido por SMS — o envio é feito para o mesmo número.
Validação por SMS: digite o código recebido no celular.
4 Confira os dados e toque em Confirmar.
5 O Token Juno valida a ação e a chave Pix de telefone fica criada.
Chave Pix de telefone criada — anote o número exatamente como cadastrado.
E no Quaza? Depois de criada, vá em Configuração para cobrança → aba Gateway e cole esse número de telefone no campo Chave PIX da carteira modelo que usa o gateway Juno.
Pegadinhas frequentes
1. O telefone precisa estar ativo. O Juno envia o código por SMS — sem sinal/celular ativo, não dá para validar.
2. A chave fica vinculada ao número. Se trocar de número, é preciso criar uma nova chave (com o novo número) e atualizar no Quaza.
3. Uma chave por tipo. Cada conta Juno aceita uma chave de cada tipo (uma de Celular, uma de E-mail, etc.).
4. Anote como cadastrou. Cole no Quaza exatamente como aparece no app (com DDD), sem espaços.
Perguntas frequentes
Posso usar qualquer número de celular?Sim, desde que esteja ativo (recebendo SMS) e seja seu — a Juno valida por SMS o número informado.
Quanto tempo leva para a chave ficar pronta?Em geral, alguns segundos após o token validar a ação no app.
A chave Pix de telefone tem custo?Não cobramos pela criação no Quaza; eventuais custos do banco/Juno seguem o que estiver no seu contrato.
Posso ter mais de uma chave Pix?Sim — por tipo. Por exemplo, uma de Celular e uma de E-mail, para a mesma conta.
Onde uso essa chave depois?No Quaza, em Configuração para cobrança → aba Gateway, no campo Chave PIX da carteira modelo configurada com o gateway Juno.
E se eu perder o celular?Bloqueie/altere a chave na Juno (pelo suporte da Juno) e crie uma nova com o novo número, atualizando o campo Chave PIX no Quaza.
Posso criar a chave em outro banco e usar no gateway Juno?Não — a chave precisa estar registrada na sua conta Juno (é por onde os Pix vão chegar).
Não recebo o SMS, o que fazer?Confira sinal e dados cadastrados; em caso de falha persistente, contate o suporte da Juno.
Posso mudar o número da chave depois?Não diretamente — é preciso remover a chave antiga e criar uma nova com o novo número (e atualizar no Quaza).
Onde vejo a chave já cadastrada na Juno?No próprio app Juno, na seção Pix → minhas chaves.
Documentos relacionados