Pagamento no Portal
O Guest Booking Portal (GBP) oferece pagamento integrado para que hospedes finalizem a reserva com seguranca. O portal usa os gateways vinculados a propriedade: o Opero Payment (Stripe Connect) para cartao e outros gateways (Pagar.me, Mercado Pago, GetNet, Asaas, entre outros) para cartao, PIX e boleto.
Metodos de Pagamento
O portal mostra apenas os metodos permitidos nos gateways vinculados a propriedade.
Cartao de Credito e Debito
O pagamento por cartao e processado pelo gateway da propriedade:
- Opero Payment / Stripe: o cartao e digitado no formulario do Stripe (Stripe Elements)
- GetNet, Mercado Pago e Pagar.me: o cartao e tokenizado no navegador pelo gateway
- Suporte as bandeiras principais (Visa, Mastercard, Elo, Amex, etc.)
- No Opero Payment, split de pagamento automatico (Opero recebe a taxa de plataforma, hotel recebe o valor liquido)
PIX
O PIX e gerado pelo gateway da propriedade:
- QR Code exibido na tela de pagamento
- Copia-e-cola para pagamento via app do banco
- Confirmacao em tempo real (segundos)
- O QR Code expira em 10 minutos
Boleto
O boleto e emitido pelo gateway (Pagar.me, Mercado Pago ou Asaas). A reserva e confirmada com o pagamento pendente ate a compensacao.
Fluxo de Pagamento
Perspectiva do Hospede
1. Seleciona datas e quarto
↓
2. Preenche dados pessoais (nome, email, telefone, documento)
↓
3. Escolhe metodo de pagamento (cartao, PIX ou boleto)
↓
4. Cartao: preenche dados → gateway processa → confirmacao instantanea
PIX: exibe QR Code → hospede paga no app do banco → confirmacao em segundos
↓
5. Recebe a confirmacao com codigo da reserva (na tela e por mensagem)O quarto fica bloqueado por 10 minutos enquanto o hospede preenche os dados e paga.
Perspectiva do Admin
- A reserva aparece no modulo Reservas do dashboard com status “Confirmada”
- O pagamento fica vinculado a reserva, com o valor pago e o status de pagamento (Pago, Parcial ou Pendente)
- O pagamento aparece no painel do gateway (no Opero Payment, na aba Payments)
Configurar Pagamentos
Conectar Stripe
- Acesse Opero Payment (OP) > Gateway de Pagamento
- Selecione a propriedade e clique em “Criar Conta Express”
- Complete o onboarding do Stripe na propria pagina (dados bancarios, documentos)
- Apos aprovacao, o status muda para “Ativo”
Nota: O Stripe exige verificacao de identidade e dados bancarios da sua empresa. Este processo pode levar de algumas horas a 2 dias uteis.
Configurar PIX
- Cadastre um gateway com PIX em Configuracoes > Gateways de Pagamento (Pagar.me, Mercado Pago, GetNet, Asaas, Stone ou Abacate Pay)
- Em Vinculos com Propriedades, inclua PIX nos metodos permitidos da propriedade
- O QR Code e gerado pelo gateway; nao e necessario cadastrar chave PIX no Opero
Escolher Politica de Pagamento
Configure como o portal cobra o hospede:
| Politica | Descricao | Quando Usar |
|---|---|---|
| Pagamento antecipado total | Hospede paga 100% no ato da reserva | Tarifas nao-reembolsaveis, alta demanda |
| Pagamento antecipado parcial | Hospede paga X% agora, restante no check-in | Equilibrio entre garantia e flexibilidade |
| Pagamento no check-in | Hospede reserva sem pagar; o valor total e cobrado no check-in | Tarifas flexiveis, baixa temporada |
Para configurar:
- Na propriedade, acesse a aba Settings > Payment Policy
- Selecione a politica desejada
- Para pagamento parcial, defina o percentual do sinal (1% a 99%, ex: 30%, 50%)
- Salve
Seguranca
PCI DSS Compliance
O Opero nunca armazena dados completos de cartao de credito. Os dados do cartao:
- Sao inseridos no formulario do Stripe (Stripe Elements) ou tokenizados no navegador pelo gateway
- O numero do cartao nao passa pelos servidores do Opero
- Dados sensiveis sao removidos antes de gravar as respostas dos gateways
Reembolsos
Em caso de cancelamento com direito a reembolso:
- Acesse a reserva cancelada no modulo Reservas
- Clique em “Solicitar reembolso”
- Informe o valor (total ou parcial) e o motivo
- 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: o hotel devolve o valor no painel do gateway (no Opero Payment, na aba Payments) ou, no PIX, por transferencia ao hospede.
Parcelamento
Quando o cartao de credito e digitado no formulario do portal (GetNet, Mercado Pago, Pagar.me), o hospede pode escolher de 1x a 12x, exibido como “sem juros”. Nao ha configuracao de numero maximo de parcelas, parcela minima ou juros.
Integracao com o Financeiro
Todo pagamento recebido pelo portal fica vinculado a reserva: o valor pago e o status de pagamento sao atualizados automaticamente. O portal nao gera lancamentos contabeis nem movimentacoes de caixa por pagamento.
Moedas
O portal exibe precos na moeda transacional da propriedade (padrao: BRL). Todos os valores financeiros sao armazenados em centavos (inteiros) para evitar erros de arredondamento.
Troubleshooting
| Problema | Causa Provavel | Solucao |
|---|---|---|
| ”Pagamento recusado” | Cartao sem limite ou bloqueado pelo banco | Hospede deve tentar outro cartao ou contatar o banco |
| PIX nao confirma | Webhook do gateway nao cadastrado ou QR Code expirado | Verifique o webhook do gateway; o QR Code expira em 10 minutos |
| Stripe nao conecta | Onboarding incompleto | Complete todos os passos de verificacao do Stripe |
| Reembolso nao aparece | Devolucao nao feita no gateway | O Opero apenas registra o reembolso; faca a devolucao no gateway |
| Parcelamento indisponivel | Cartao coletado pelo Stripe | O seletor de parcelas so aparece quando o cartao e digitado no formulario do portal |