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.
A loja recebeu “em processamento” no primeiro instante.
- 1 de 3RedeTO · tempo esgotado
- 2 de 3GetNetAutorizado
payment.completedComo 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.
-
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.
-
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.
-
03 · Rota
A adquirente é escolhida
Histórico, saúde no último minuto, plano horário e custo definem para onde vai cada venda.
-
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.
-
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
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}
POST {endereco_de_aviso_da_loja}
X-Omnipay-Signature: {hmac_sha256_do_corpo}
X-Omnipay-Event: payment.completed
{
"transactionId": "{transactionId}",
"merchantId": "{merchantId}",
"brand": "{bandeira}",
"acquirer": "{adquirente}",
"status": "{situacao}",
"attemptId": "{attemptId}",
"attemptNumber": {tentativa},
"amountCents": {valor_em_centavos},
"feeCents": {taxa_em_centavos},
"latencyMs": {tempo_de_resposta},
"declineReason": "{motivo}",
"rawCode": "{codigo_original}",
"rawMessage": "{mensagem_original}",
"occurredAt": "{horario}"
}
Mesma base
Os outros produtos da plataforma.
- AntifraudeOmniScore
Aprovar, desafiar, revisar ou negar cada pedido com a regra do seu time de risco.
Conhecer o OmniScore - MaioridadeOmniAge
Maior ou menor de idade, sem expor a data de nascimento.
Conhecer o OmniAge - ConfirmaçãoOmniLink
Quando o Score desafia, o próprio cliente confirma pelo WhatsApp, SMS ou e-mail.
Conhecer o OmniLink
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.