PIX

O PIX e o sistema de pagamentos instantaneos do Banco Central do Brasil, integrado ao Opero Payment para permitir que hospedes paguem reservas, diarias e servicos com liquidacao imediata. O Opero gera QR codes (estaticos e dinamicos) e confirma o pagamento automaticamente via webhook.

Como funciona o PIX no Opero?

Quando um hospede opta por pagar com PIX, o fluxo e:

┌──────────────┐     ┌──────────────────┐     ┌──────────────────┐
│   Hospede    │     │   Opero Payment  │     │  Banco Central   │
│              │     │                  │     │   (SPI)          │
│ 1. Escolhe   │────▸│ 2. Gera QR code  │     │                  │
│    PIX       │     │    dinamico      │     │                  │
│              │◂────│    (copia-cola)  │     │                  │
│ 3. Abre app  │     │                  │     │                  │
│    do banco  │────▸│                  │────▸│ 4. Processa      │
│    e paga    │     │                  │     │    transferencia  │
│              │     │ 6. Confirma      │◂────│ 5. Notifica via  │
│              │     │    pagamento     │     │    webhook       │
│              │◂────│ 7. Atualiza      │     │                  │
│ 8. Recebe    │     │    reserva       │     │                  │
│    confirmacao     │                  │     │                  │
└──────────────┘     └──────────────────┘     └──────────────────┘

O tempo total do fluxo e de segundos — o hospede paga e a reserva e confirmada praticamente em tempo real.

Tipos de QR Code

QR Code Dinamico

Gerado para cada transacao individual com valor e identificacao unicos:

• Valor fixo — O montante exato da reserva/servico
• Identificacao unica — Vinculado ao payment intent, permitindo conciliacao automatica
• Expiracao — Configuravel (padrao: 30 minutos)
• Uso unico — Apos o pagamento, o QR code e invalidado

O QR code dinamico e o padrao para pagamentos no Opero. Ele garante que o valor pago corresponda exatamente ao valor cobrado.

QR Code Estatico

Opcional, para cenarios onde o valor nao e fixo:

• Sem valor predefinido — O hospede digita o valor no app do banco
• Reutilizavel — Pode ser impresso e deixado na recepcao
• Sem expiracao — Funciona indefinidamente
• Conciliacao manual — O sistema tenta vincular automaticamente, mas pode exigir conciliacao manual

Recomendacao: Prefira QR codes dinamicos para pagamentos de reservas. Use estaticos apenas para gorjetas, doacoes ou pagamentos avulsos na recepcao.

Configurar PIX

Pre-requisitos

1. A propriedade deve ter uma chave PIX cadastrada no modulo financeiro. Consulte Chaves PIX
2. O gateway de pagamento deve suportar PIX (Stripe suporta PIX no Brasil)
3. A conta Stripe da propriedade deve estar ativa e verificada

Ativar PIX como metodo de pagamento

1. Acesse Configuracoes > Pagamentos > Metodos
2. Ative o toggle “PIX”
3. Configure:

Liquidacao

A grande vantagem do PIX e a liquidacao instantanea:

Impacto no fluxo de caixa

Como o PIX liquida instantaneamente, o dinheiro esta disponivel na conta da propriedade imediatamente. Isso melhora significativamente o fluxo de caixa em comparacao com cartao de credito.

PIX no Portal de Reservas

Quando o hospede faz uma reserva pelo Portal de Reservas (GBP):

1. Na tela de pagamento, seleciona “PIX”
2. O sistema exibe o QR code e o codigo copia-e-cola
3. O hospede escaneia com o app do banco ou copia o codigo
4. Apos pagamento, a pagina atualiza automaticamente (polling a cada 3 segundos)
5. A reserva e confirmada e o hospede recebe email de confirmacao

PIX na recepcao (check-in)

O recepcionista pode gerar um QR code PIX diretamente no sistema:

1. Na tela da reserva, clique em “Registrar Pagamento”
2. Selecione “PIX”
3. O QR code e exibido na tela (o hospede escaneia com o celular)
4. Apos confirmacao, o pagamento e registrado automaticamente

Estornos via PIX

O PIX nao possui mecanismo nativo de chargeback, mas o Opero permite devolucoes voluntarias:

• Devolucao total: Reembolso integral do valor pago
• Devolucao parcial: Reembolso de parte do valor (ex.: diferenca de tarifa)
• Prazo: Ate 90 dias apos o pagamento original (limite do Banco Central)

Para processar uma devolucao:

1. Acesse a reserva do hospede
2. Clique em “Estornar Pagamento”
3. Selecione o pagamento PIX a estornar
4. Informe o valor (total ou parcial) e o motivo
5. Confirme — o valor e devolvido a chave PIX do hospede

Boas praticas

1. Use QR dinamico para reservas — Garante conciliacao automatica e evita erros de valor
2. Configure expiracao adequada — 30 minutos para reservas online; 5 minutos para pagamento presencial
3. Monitore pagamentos expirados — QR codes nao pagos devem ser cancelados para liberar o inventario
4. Promova o PIX — Por ter taxa menor que cartao, incentive hospedes a usar PIX
5. Cadastre chaves PIX corretamente — Use CNPJ ou chave aleatoria; evite email ou telefone pessoal