Skip to Content
Opero PaymentMulti-Gateway

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

GatewayMetodos
Opero Payment (Stripe Connect)Cartao de credito
StripeCartao de credito
Pagar.meCartao de credito, debito, PIX, boleto
Mercado PagoCartao de credito, PIX, boleto
GetNetCartao de credito, debito, PIX
AsaasCartao de credito, PIX, boleto
StoneCartao de credito, debito, PIX
RedeCartao de credito, debito
Abacate PayPIX

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

  1. Acesse Configuracoes > Gateways de Pagamento
  2. Clique em “Adicionar Gateway”
  3. Selecione o provedor da lista
  4. Preencha os dados:
CampoDescricao
Nome de ExibicaoNome do gateway no Opero
Identificador da ContaIdentificador da conta no gateway
MoedaMoeda aceita pelo gateway
CredenciaisChaves exigidas pelo provedor (ex.: API Key, Secret Key, Access Token), armazenadas criptografadas
SandboxModo de teste, quando o provedor oferece
Vincular a propriedadesOpcional — propriedades que usarao o gateway
  1. Ao salvar, o Opero exibe o endpoint de webhook (e o secret) para cadastrar no painel do gateway
  2. Clique em “Testar” para validar as credenciais

Status do gateway

StatusDescricao
AtivoGateway disponivel para transacoes
InativoGateway desativado

Vinculos com propriedades

Na secao Vinculos com Propriedades, defina para cada propriedade:

CampoExemplo
Metodos PermitidosPIX e boleto no Mercado Pago; cartao no Opero Payment
PadraoGateway 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

  1. Vincule cada propriedade — Defina os metodos permitidos e o gateway padrao de cada uma
  2. Configure roteamento por metodo — PIX e cartao podem usar gateways diferentes
  3. Teste gateways em sandbox antes — Valide a integracao antes de ativar em producao
  4. Cadastre o webhook no gateway — Ele agiliza a confirmacao de PIX e boleto
  5. Revise taxas periodicamente — Negocie com gateways conforme o volume de transacoes cresce
Last updated on