Multi-Gateway
O Opero Payment suporta 9 gateways de pagamento. Cada tenant cadastra os gateways que contratou e os vincula as suas propriedades, definindo quais metodos cada gateway atende e qual e o padrao. Isso permite que propriedades escolham o gateway de cada metodo de pagamento.
Por que usar multiplos gateways?
Depender de um unico gateway de pagamento cria limitacoes:
- Cobertura limitada: Nem todo gateway suporta todos os metodos (ex.: PIX ou boleto)
- Custos elevados: Diferentes gateways tem taxas melhores para diferentes metodos
- Propriedades diferentes: Cada propriedade pode usar um gateway proprio
Importante: O Opero nao faz failover entre gateways. Se a cobranca falhar, o pagamento e recusado e o hospede pode tentar novamente.
Gateways suportados
| Gateway | Metodos |
|---|---|
| Opero Payment (Stripe Connect) | Cartao de credito |
| Stripe | Cartao de credito |
| Pagar.me | Cartao de credito, debito, PIX, boleto |
| Mercado Pago | Cartao de credito, PIX, boleto |
| GetNet | Cartao de credito, debito, PIX |
| Asaas | Cartao de credito, PIX, boleto |
| Stone | Cartao de credito, debito, PIX |
| Rede | Cartao de credito, debito |
| Abacate Pay | PIX |
Nota: Nenhum gateway e obrigatorio. Cada gateway precisa estar contratado na Loja (ou liberado pela equipe Opero) antes do cadastro.
Configurar um gateway adicional
Passo a passo
- Acesse Configuracoes > Gateways de Pagamento
- Clique em “Adicionar Gateway”
- Selecione o provedor da lista
- Preencha os dados:
| Campo | Descricao |
|---|---|
| Nome de Exibicao | Nome do gateway no Opero |
| Identificador da Conta | Identificador da conta no gateway |
| Moeda | Moeda aceita pelo gateway |
| Credenciais | Chaves exigidas pelo provedor (ex.: API Key, Secret Key, Access Token), armazenadas criptografadas |
| Sandbox | Modo de teste, quando o provedor oferece |
| Vincular a propriedades | Opcional — propriedades que usarao o gateway |
- Ao salvar, o Opero exibe o endpoint de webhook (e o secret) para cadastrar no painel do gateway
- Clique em “Testar” para validar as credenciais
Status do gateway
| Status | Descricao |
|---|---|
| Ativo | Gateway disponivel para transacoes |
| Inativo | Gateway desativado |
Vinculos com propriedades
Na secao Vinculos com Propriedades, defina para cada propriedade:
| Campo | Exemplo |
|---|---|
| Metodos Permitidos | PIX e boleto no Mercado Pago; cartao no Opero Payment |
| Padrao | Gateway preferido quando mais de um atende o metodo |
Como o gateway e escolhido
Para cada pagamento, o Opero considera os gateways ativos vinculados a propriedade que permitem o metodo escolhido, aceitam a moeda e estao contratados pelo tenant. O gateway marcado como Padrao tem preferencia. Se a propriedade nao tiver nenhum vinculo, e usado o primeiro gateway ativo do tenant.
Nao ha regras por bandeira, valor ou pais do cartao.
Boas praticas
- Vincule cada propriedade — Defina os metodos permitidos e o gateway padrao de cada uma
- Configure roteamento por metodo — PIX e cartao podem usar gateways diferentes
- Teste gateways em sandbox antes — Valide a integracao antes de ativar em producao
- Cadastre o webhook no gateway — Ele agiliza a confirmacao de PIX e boleto
- Revise taxas periodicamente — Negocie com gateways conforme o volume de transacoes cresce