Chaves PIX
O que é
Chaves PIX são identificadores vinculados a uma conta bancária que permitem receber pagamentos instantâneos via sistema PIX do Banco Central. No Opero, as chaves PIX são cadastradas por conta bancária, como referência da conta:
- Registram quais chaves cada conta bancária usa
- Guardam o período de vigência de cada chave
O Opero não gera QR Codes nem cobra via estas chaves. Cobranças PIX de reservas (inclusive pelo Guest Booking Portal) são feitas pelo OPERO PAYMENT, por meio do gateway de pagamento.
Tipos de chave PIX
O sistema PIX aceita cinco tipos de chave, cada um com características diferentes:
| Tipo | Formato | Exemplo | Observação |
|---|---|---|---|
| CPF | 11 dígitos | 123.456.789-00 | Vinculado ao titular pessoa física |
| CNPJ | 14 dígitos | 12.345.678/0001-90 | Ideal para contas PJ (hotéis) |
| Endereço de email | financeiro@hotel.com.br | Fácil de lembrar e compartilhar | |
| Telefone | +55 DDD + número | +55 11 99999-0000 | Vinculado ao celular do responsável |
| Aleatória (EVP) | UUID gerado pelo banco | a1b2c3d4-e5f6-7890-abcd-ef1234567890 | Não expõe dados pessoais |
No formulário, os tipos aparecem como CPF, CNPJ, EMAIL, PHONE e RANDOM (chave aleatória).
Recomendação para hotéis: Use CNPJ como chave principal (institucional) e chave aleatória quando precisar divulgar a chave (não expõe dados sensíveis ao hóspede).
Cadastrar uma chave PIX
Pré-requisito
As chaves PIX são cadastradas junto com a conta bancária, no formulário de criação, e só para contas do Brasil. Veja Contas Bancárias.
Passo a passo
- Acesse Financeiro → Gestão de Caixa, aba Contas Bancárias
- Clique “Nova Conta Bancária” e preencha os dados bancários
- Na seção Chaves Pix, clique “Adicionar Chave Pix”
- Selecione o Tipo da Chave
- Informe o Valor da Chave (CPF, CNPJ, email, telefone ou cole a chave aleatória)
- Informe o Início da Vigência e, se a chave já tiver data para deixar de valer, o Fim da Vigência
- Salve a conta
Importante: A chave precisa estar registrada no banco antes de cadastrá-la no Opero. O sistema não registra chaves junto ao BACEN — ele apenas armazena a referência para uso interno.
Limite de chaves
O Opero não limita a quantidade de chaves por conta, mas não aceita a mesma chave ativa duas vezes.
Geração de QR Code
O Opero não gera QR Codes PIX (estáticos ou dinâmicos) a partir das chaves cadastradas, nem tem a opção “Cobrar via PIX” em Contas a Receber.
Fluxo de pagamento via PIX
Um PIX recebido na conta não é registrado automaticamente pela chave. Ele entra no Opero como qualquer transação bancária:
- pela importação do extrato ou pela sincronização Open Finance (vira uma movimentação a categorizar); ou
- ao registrar o recebimento em Contas a Receber.
Integração com o portal de reservas
O PIX do Guest Booking Portal é processado pelo gateway configurado no OPERO PAYMENT, sem usar as chaves cadastradas aqui.
Gerenciar chaves
Depois que a conta bancária é criada, a tela não mostra, edita nem remove as chaves PIX. Não há rótulo nem chave padrão.
PIX e conciliação
Pagamentos PIX aparecem no extrato bancário e são conciliados como qualquer transação, pelo valor e pela data — o identificador do PIX não é usado no matching.
Para mais detalhes sobre o processo de conciliação, veja Conciliação Bancária.
Boas práticas
- Use CNPJ para cobranças formais — Transmite credibilidade institucional
- Use chave aleatória quando for divulgar — Não exponha CNPJ ou email em páginas públicas
- Informe a vigência — Use o fim da vigência para registrar chaves que deixaram de valer
- Cadastre as chaves ao criar a conta — Depois, a tela não permite incluí-las
- Mantenha chaves atualizadas — Se trocar de banco, cadastre a nova conta com as novas chaves
- Concilie diariamente — PIX é instantâneo, mas a conciliação garante que tudo foi registrado