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 e podem ser usadas para:

• Receber pagamentos de hóspedes
• Gerar QR Codes para cobrança
• Facilitar transferências entre contas da propriedade
• Receber via portal de reservas (Guest Booking Portal)

Tipos de chave PIX

O sistema PIX aceita cinco tipos de chave, cada um com características diferentes:

Recomendação para hotéis: Use CNPJ como chave principal (institucional) e chave aleatória para cobranças no portal de reservas (não expõe dados sensíveis ao hóspede).

Cadastrar uma chave PIX

Pré-requisito

A chave PIX deve estar vinculada a uma conta bancária já cadastrada. Se ainda não cadastrou a conta, veja Contas Bancárias.

Passo a passo

1. Acesse Financeiro → Caixa
2. Clique na conta bancária desejada
3. Acesse a aba “Chaves PIX”
4. Clique “Adicionar Chave PIX”
5. Selecione o tipo de chave
6. Informe o valor da chave (CPF, CNPJ, email, telefone ou cole a chave aleatória)
7. Opcionalmente, adicione um rótulo (ex.: “PIX Reservas”, “PIX Eventos”)
8. Clique “Salvar”

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 e geração de QR Codes.

Limite de chaves

Cada conta bancária pode ter até 5 chaves PIX cadastradas no Opero, respeitando o limite do regulamento do BACEN.

Geração de QR Code

O Opero gera dois tipos de QR Code PIX:

QR Code estático

• Valor não definido (o pagador digita o valor)
• Ideal para recepção ou balcão
• Pode ser impresso e reutilizado

Para gerar:

1. Na conta bancária, selecione a chave PIX
2. Clique “Gerar QR Code Estático”
3. Opcionalmente, defina uma descrição (ex.: “Hotel Opero - Pagamento”)
4. Imprima ou copie o código

QR Code dinâmico (cobrança)

• Valor definido e vinculado a uma fatura específica
• Expira após o pagamento ou prazo configurado
• Permite rastreamento automático do pagamento

Para gerar:

1. Na fatura (Contas a Receber), clique “Cobrar via PIX”
2. Selecione a chave PIX da conta de destino
3. O sistema gera um QR Code com:
   • Valor exato da fatura (ou saldo pendente)
   • Identificador único vinculado ao receivable
   • Data de expiração
4. Envie ao cliente por email ou WhatsApp (via OCP)

Dica: QR Codes dinâmicos permitem baixa automática da fatura quando o pagamento é confirmado pelo banco.

Fluxo de pagamento via PIX

Hóspede escaneia QR Code PIX
       │
       ▼
Confirma pagamento no app do banco
       │
       ▼
Banco processa o PIX (instantâneo)
       │
       ▼
Opero recebe notificação (webhook ou sync)
       │
       ▼
Sistema registra automaticamente:
  ├── Movimentação de entrada na conta bancária
  ├── Baixa parcial ou total na fatura (AR)
  └── Lançamento contábil (Débito Banco, Crédito AR)

Integração com o portal de reservas

Quando o hóspede faz uma reserva pelo Guest Booking Portal e escolhe pagar via PIX:

1. O portal gera um QR Code dinâmico automaticamente
2. O hóspede paga pelo app do banco
3. A reserva é confirmada após o pagamento
4. O receivable é criado e já marcado como recebido

Gerenciar chaves

Visualizar chaves cadastradas

Em cada conta bancária, a aba “Chaves PIX” lista todas as chaves com:

• Tipo e valor da chave
• Rótulo (se definido)
• Data de cadastro
• Status (ativa/inativa)

Editar rótulo

Você pode alterar o rótulo de uma chave a qualquer momento sem afetar o funcionamento.

Remover chave

1. Selecione a chave
2. Clique “Remover”
3. Confirme

Atenção: Ao remover uma chave, QR Codes estáticos gerados com ela deixam de funcionar. QR Codes dinâmicos já pagos não são afetados.

Definir chave padrão

Se a conta possui múltiplas chaves, marque uma como “Padrão”. Ela será usada automaticamente ao gerar cobranças PIX a partir de faturas dessa conta.

PIX e conciliação

Pagamentos PIX aparecem no extrato bancário e devem ser conciliados normalmente:

Para mais detalhes sobre o processo de conciliação, veja Conciliação Bancária.

Boas práticas

1. Use CNPJ para cobranças formais — Transmite credibilidade institucional
2. Use chave aleatória no portal — Não exponha CNPJ ou email em páginas públicas
3. Defina rótulos claros — Facilita identificar qual chave é usada para quê
4. Prefira QR dinâmico — A baixa automática economiza tempo e reduz erros
5. Mantenha chaves atualizadas — Se trocar de banco, atualize as chaves no Opero
6. Concilie diariamente — PIX é instantâneo, mas a conciliação garante que tudo foi registrado