Skip to Content

PIX

O PIX e o sistema de pagamentos instantaneos do Banco Central do Brasil, integrado ao Opero Payment para permitir que hospedes paguem reservas e saldos no check-in. O QR code e gerado pelo gateway vinculado a propriedade (Pagar.me, Mercado Pago, GetNet, Asaas, Stone ou Abacate Pay), e o pagamento e confirmado pelo webhook do gateway ou por consulta de status.


Como funciona o PIX no Opero?

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

┌──────────────┐ ┌──────────────────┐ ┌──────────────────┐ │ Hospede │ │ Opero Payment │ │ Gateway │ │ │ │ │ │ (PIX) │ │ 1. Escolhe │────▸│ 2. Gera QR code │ │ │ │ PIX │ │ dinamico │ │ │ │ │◂────│ (copia-cola) │ │ │ │ 3. Abre app │ │ │ │ │ │ do banco │────▸│ │────▸│ 4. Recebe o │ │ e paga │ │ │ │ pagamento │ │ │ │ 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.


QR Code Dinamico

Todo PIX no Opero e um QR code dinamico, gerado para cada cobranca com valor e identificacao unicos:

  • Valor fixo — O montante exato da reserva ou do saldo
  • Identificacao unica — Vinculado a transacao, permitindo a confirmacao automatica
  • Expiracao — 10 minutos no Portal de Reservas (o mesmo prazo do bloqueio do quarto); quando nao informada, a maioria dos gateways usa 30 minutos
  • Uso unico — Apos o pagamento, o QR code e invalidado

Nao ha QR code estatico.


Configurar PIX

Pre-requisitos

  1. Um gateway que suporte PIX: Pagar.me, Mercado Pago, GetNet, Asaas, Stone ou Abacate Pay (o Opero Payment/Stripe Connect nao oferece PIX)
  2. O gateway cadastrado e ativo em Configuracoes > Gateways de Pagamento

Ativar PIX como metodo de pagamento

  1. Acesse Configuracoes > Gateways de Pagamento
  2. Em Vinculos com Propriedades, inclua PIX nos Metodos Permitidos do gateway na propriedade
  3. Cadastre no painel do gateway o endpoint de webhook exibido pelo Opero

Nao ha configuracoes adicionais de PIX (expiracao, envio do QR ao hospede ou QR na fatura).


Liquidacao

O PIX e confirmado em segundos. O prazo para o valor chegar a conta da propriedade depende do gateway contratado.


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 a confirmacao

PIX na recepcao (check-in)

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

  1. Faca o check-in de uma reserva com saldo em aberto
  2. Na janela de pagamento do check-in, selecione PIX
  3. O QR code e exibido na tela (o hospede escaneia com o celular) ou o codigo PIX pode ser copiado
  4. Apos confirmacao, o pagamento e registrado automaticamente

Estornos via PIX

O PIX nao possui mecanismo nativo de chargeback. No Opero, o reembolso e um pedido registrado na reserva:

  1. Acesse a reserva cancelada (ou no-show)
  2. Clique em “Solicitar reembolso”
  3. Informe o valor (total ou parcial) e o motivo
  4. Pedidos abaixo do limite de aprovacao automatica sao processados na hora; valores maiores exigem aprovacao do gerente

O Opero registra o reembolso, mas nao envia a devolucao ao gateway: a devolucao do PIX ao hospede e feita pelo hotel no painel do gateway ou no banco.


Boas praticas

  1. Use um gateway com PIX para reservas online — Garante confirmacao automatica e evita erros de valor
  2. Cadastre o webhook no gateway — Agiliza a confirmacao do pagamento
  3. Oriente o hospede sobre o prazo — No portal, o QR code expira em 10 minutos
  4. Promova o PIX — Por ter taxa menor que cartao, incentive hospedes a usar PIX
Last updated on