Multi-Gateway
O Opero Payment suporta ate 8 provedores de pagamento simultaneamente, com failover automatico e roteamento inteligente. Isso garante alta disponibilidade e permite que propriedades escolham os melhores gateways para cada metodo de pagamento e regiao.
Por que usar multiplos gateways?
Depender de um unico gateway de pagamento cria riscos:
- Indisponibilidade: Se o gateway cai, a propriedade nao consegue receber pagamentos
- Cobertura limitada: Nem todo gateway opera em todos os paises ou suporta todos os metodos
- Custos elevados: Diferentes gateways tem taxas melhores para diferentes metodos
- Restricoes de volume: Alguns gateways limitam o volume de transacoes para contas novas
O multi-gateway do Opero resolve todos esses problemas.
Gateways suportados
| Gateway | Pais/Regiao | Metodos principais | Status |
|---|---|---|---|
| Stripe | Global | Cartao, PIX, boleto, Apple Pay, Google Pay | Principal |
| MercadoPago | America Latina | Cartao, PIX, boleto, parcelamento | Ativo |
| PagSeguro | Brasil | Cartao, PIX, boleto | Ativo |
| Cielo | Brasil | Cartao, debito, PIX | Ativo |
| Rede | Brasil | Cartao, debito | Ativo |
| Adyen | Global | Cartao, metodos locais por pais | Ativo |
| PayPal | Global | Saldo PayPal, cartao | Ativo |
| Stone | Brasil | Cartao, PIX | Ativo |
Nota: O Stripe Connect e o gateway principal e obrigatorio. Os demais sao opcionais e complementares.
Configurar um gateway adicional
Passo a passo
- Acesse Configuracoes > Pagamentos > Gateways
- Clique em “Adicionar Gateway”
- Selecione o provedor da lista
- Preencha as credenciais:
| Campo | Descricao |
|---|---|
| API Key | Chave de API fornecida pelo gateway |
| Secret Key | Chave secreta (armazenada criptografada via AWS KMS) |
| Webhook URL | URL para o gateway enviar notificacoes (gerada automaticamente) |
| Ambiente | Sandbox (teste) ou Producao |
| Prioridade | Ordem de preferencia (1 = maior prioridade) |
- Clique em “Testar Conexao” para validar as credenciais
- Ative o gateway
Status do gateway
| Status | Descricao |
|---|---|
| Ativo | Gateway operacional e disponivel para transacoes |
| Inativo | Gateway configurado mas desabilitado |
| Erro | Falha na conexao ou credenciais invalidas |
| Sandbox | Gateway em modo de teste (nao processa pagamentos reais) |
Roteamento inteligente
O Opero permite configurar regras de roteamento que direcionam cada pagamento para o gateway mais adequado.
Regras de roteamento
| Criterio | Exemplo |
|---|---|
| Metodo de pagamento | PIX → MercadoPago; Cartao → Stripe |
| Bandeira do cartao | Visa/Master → Stripe; Elo → Cielo |
| Valor da transacao | Abaixo de R$ 100 → PagSeguro; Acima → Stripe |
| Pais do cartao | Brasil → Cielo; Internacional → Stripe |
| Propriedade | Hotel SP → Stripe; Hotel Cancun → Adyen |
Configurar regras
- Acesse Configuracoes > Pagamentos > Roteamento
- Clique em “Nova Regra”
- Defina o criterio e o gateway de destino
- Defina a prioridade (regras sao avaliadas em ordem)
- Salve
O sistema avalia as regras de cima para baixo. A primeira regra que corresponder ao pagamento e aplicada. Se nenhuma regra corresponder, o gateway padrao (Stripe) e utilizado.
Failover automatico
Quando o gateway principal de uma transacao falha, o Opero tenta automaticamente o proximo gateway na fila.
Como funciona
Hospede tenta pagar com cartao
│
▼
Gateway 1 (Stripe) ──── Falha (timeout)
│
▼
Gateway 2 (Cielo) ──── Falha (cartao recusado)
│
▼
Gateway 3 (Adyen) ──── Sucesso!
│
▼
Pagamento confirmado (hospede nao percebe a troca)Configurar failover
- Acesse Configuracoes > Pagamentos > Failover
- Defina a ordem de tentativa por metodo de pagamento:
| Prioridade | Gateway | Timeout |
|---|---|---|
| 1 | Stripe | 10s |
| 2 | Cielo | 10s |
| 3 | Adyen | 10s |
- Configure:
| Parametro | Descricao | Padrao |
|---|---|---|
| Max tentativas | Quantos gateways tentar antes de falhar | 3 |
| Timeout por tentativa | Tempo de espera por gateway | 10 segundos |
| Tipos de erro para failover | Quais erros ativam failover | Timeout, erro de rede, indisponivel |
| Nao fazer failover em | Erros que indicam problema do cartao, nao do gateway | Cartao recusado, saldo insuficiente |
Importante: O failover so e ativado para erros de infraestrutura (timeout, rede). Se o cartao e recusado pelo banco emissor, o failover NAO e ativado (o problema e do cartao, nao do gateway).
Monitoramento
O dashboard de gateways mostra:
| Metrica | Descricao |
|---|---|
| Uptime | Disponibilidade de cada gateway nas ultimas 24h/7d/30d |
| Taxa de sucesso | Percentual de transacoes aprovadas por gateway |
| Latencia media | Tempo de resposta de cada gateway |
| Failovers ativados | Quantas vezes o failover foi necessario |
| Volume por gateway | Distribuicao de transacoes entre gateways |
Boas praticas
- Mantenha ao menos 2 gateways ativos — Garante continuidade se o principal falhar
- Configure roteamento por metodo — PIX e cartao podem ter gateways otimizados diferentes
- Teste gateways em sandbox antes — Valide a integracao antes de ativar em producao
- Monitore taxas de sucesso — Um gateway com taxa de sucesso abaixo de 95% merece investigacao
- Revise taxas periodicamente — Negocie com gateways conforme o volume de transacoes cresce