Produto · Pagamentos

OmniPay

Uma adquirente falha. A venda segue.

O OmniPay orquestra pagamentos com cartão entre o checkout e várias adquirentes. Escolhe o caminho a cada venda, responde na hora e, se a primeira adquirente recusar por um motivo temporário, tenta a próxima sozinho.

Exemplo de cascataOmniPay

A loja recebeu “em processamento” no primeiro instante.

  1. 1 de 3RedeTO · tempo esgotado
  2. 2 de 3GetNetAutorizado
Aprovadoaviso assinado payment.completed

Como funciona

A loja envia uma vez. O resto acontece em segundo plano.

A loja não espera a adquirente para seguir. Ela só fica sabendo do resultado final.

  1. 01 · Pedido

    Pagamento assinado

    Valor, moeda, número do pedido, cartão ou token e o endereço do aviso. Assinatura e chave única são obrigatórias.

  2. 02 · Resposta

    “Em processamento” na hora

    A loja recebe a confirmação de que o pagamento foi aceito e o número da transação.

  3. 03 · Rota

    A adquirente é escolhida

    Histórico, saúde no último minuto, plano horário e custo definem para onde vai cada venda.

  4. 04 · Cascata

    Nova tentativa se for temporário

    Erro técnico, demora ou recusa temporária: o OmniPay tenta a próxima adquirente da lista.

  5. 05 · Aviso

    Resultado assinado

    Com o desfecho final, a loja recebe o aviso assinado, para confirmar que veio da plataforma.

Roteamento inteligente

Quatro sinais pesam cada venda.

A escolha é um sorteio ponderado: o volume é repartido entre as adquirentes em vez de ir todo para uma só. O operador ajusta tudo no painel, e as mudanças valem na hora.

  • Histórico

    Confiabilidade, velocidade e custo de cada adquirente por loja e bandeira, recalculados a cada 5 minutos.

    Entra quandoHá pelo menos 20 transações
  • Saúde

    Olha o último minuto. A participação cai conforme sobem os erros e a lentidão; recusa do emissor não conta.

    Sai do rateio com15% de erro ou mais, e volta sozinha
  • Plano horário

    Mais ou menos preferência por adquirente, bandeira e faixa de horário, inclusive atravessando a meia-noite.

    MultiplicadorDe 0,0 a 5,0 por faixa
  • Custo

    Taxas por loja, adquirente e bandeira, cadastradas no portal.

    Sem históricoEscolhe a de menor custo esperado

Cascata

Tenta de novo só quando vale a pena.

Recusa temporária ganha outra adquirente. Recusa definitiva do banco emissor, como saldo insuficiente ou cartão inválido, não é repetida.

  • Limite padrão de 3 tentativas, ajustável por loja
  • Só participam adquirentes com roteamento automático habilitado
  • Cada tentativa é única e nunca é autorizada duas vezes
Códigos de recusaPadronizados
Tenta outra adquirente919659TO
Não tenta de novo5105571446

Erro técnico e demora da adquirente também disparam a cascata. O aviso traz o motivo padronizado e o código e a mensagem originais da adquirente.

No portal

A operação decide o que priorizar.

  • Política de roteamento

    Custo, aprovação ou velocidade

    Um objetivo pronto — Equilíbrio, Menor custo, Maior aprovação, Mais velocidade — ou Personalizado. Cada alteração vira uma versão, e reverter não apaga nada.

  • Simulação “e se”

    Veja o efeito antes de ativar

    Compare a política atual, a proposta e o que de fato aconteceu em 6 h, 12 h, 24 h, 48 h ou 7 dias: economia em taxas, perda de aprovação e a fatia de cada adquirente.

  • Inteligência artificial

    Sugere. Quem aprova é o time.

    Insights por horário, sugestão de plano horário e comparação de planos. Cada sugestão nasce pendente; nada é aplicado sem aprovação humana.

  • Teste de alternativas

    Descobrir uma rota melhor sem arriscar

    Quando a líder não está ideal, uma pequena parte das decisões testa outra adquirente com saúde igual ou melhor.

  • Proteção

    Sem cobrança em dobro

    • Reenvio com a mesma chave devolve a mesma resposta
    • Pedido travado é liberado depois de 60 segundos
    • O número do cartão não é gravado: ficam o token, o BIN e os 4 últimos dígitos
  • Rastreabilidade

    Por que a venda foi para lá

    Transações com filtros, cada tentativa com o motivo da escolha, indicadores de aprovação, custo, erros e velocidade, ranking de adquirentes e perfil por hora.

Conectores

Várias adquirentes, uma integração.

Cada adquirente entra por um conector próprio: cadastro no portal e entrada no histórico de desempenho. Incluir uma nova não muda o funcionamento do OmniPay.

Adquirentes

  • Cielo
  • Rede
  • GetNet
  • Adyen

Bandeiras

  • Visa
  • Mastercard
  • Elo
  • Amex
  • Hipercard

Checkout

  • VTEX

Antifraude no pagamento é opcional: com a checagem ligada, o OmniPay consulta o OmniScore e espera até 2 segundos. Se ele falhar ou demorar, o pagamento segue — a prioridade é não perder a venda.

Integração

Envie o pagamento. Receba o aviso.

A assinatura é um HMAC-SHA256 do corpo bruto, no cabeçalho X-Omnipay-Signature. O aviso de resultado usa o mesmo segredo, e se a loja não receber, ele é reenviado com intervalos crescentes.

  • POST/paymentsEnviar um pagamento · assinatura e chave única
  • GET/payments/{transactionId}Situação, valor e todas as tentativas
POST /payments
X-Omnipay-Signature: {hmac_sha256_do_corpo}
Idempotency-Key: {chave_unica}

# resposta imediata
em processamento + {transactionId}

# consulta, se precisar
GET /payments/{transactionId}

Próximos passos

Cada venda pela rota com mais chance de aprovar.

Demonstração para o time de operação, acessos e APIs de teste e os contratos de adquirente que você já tem.