VibeFox OpenPay for OpenCart

Visão geral

O VibeFox OpenPay Gateway adiciona ao OpenCart 3 e ao OpenCart 4 pagamentos com cartão de crédito e débito pela OpenPay (BBVA), para contas OpenPay do México, da Colômbia e do Peru. O formulário do cartão é exibido na etapa Confirm Order, mas o cartão é tokenizado no navegador pelo openpay.js, então o número do cartão e o CVV nunca chegam à sua loja. Todo pagamento passa pelo 3D Secure. O OpenCart cria o pedido antes do pagamento, mas o pedido só recebe um status depois que a OpenPay confirma a cobrança.

A extensão aceita pagamentos únicos com cartão, capturados imediatamente. Não tem cartões salvos, assinaturas, parcelamento sem juros (MSI) ou parcelado, pagamentos com pontos do cartão, dinheiro, SPEI, PSE ou CoDi, nem autorização e captura separadas.

Principais recursos

Formulário de cartão com 3D Secure: formulário do cartão na etapa Confirm Order, tokenizado pelo openpay.js com a verificação antifraude de dispositivo da OpenPay; cada cobrança passa pelo 3D Secure na página do banco.

Pago somente quando a OpenPay confirma: a cobrança é consultada novamente na API da OpenPay quando o cliente volta do 3D Secure e quando chega o webhook. Só então o OpenCart envia seus e-mails habituais de pedido.

Verificação de valor e moeda: uma cobrança concluída precisa corresponder exatamente ao total e à moeda do pedido. Se houver divergência, o pedido vai para um status de análise com uma observação, sem ser marcado como pago.

Nunca cobrado duas vezes: um carrinho que já foi pago nunca é cobrado de novo, e antes de uma nova tentativa a cobrança anterior do carrinho é verificada.

Sandbox e produção: Merchant ID, chave privada e chave pública separados para cada modo. Reembolsos e webhooks sempre usam as chaves do modo e do país da conta em que a cobrança foi feita.

Reembolsos na página do pedido: reembolsos totais e parciais na aba VibeFox OpenPay Gateway do pedido, para o México e o Peru (Colômbia: no painel da OpenPay). Reembolsos e chargebacks feitos no painel são registrados no pedido.

Mensagens claras para o cliente: cartão vencido, saldo insuficiente, CVV incorreto, falha no 3D Secure e outros erros da OpenPay recebem mensagens curtas; erros técnicos nunca são mostrados aos clientes.

Seus próprios status de pedido e condições do OpenCart: escolha os status para pedidos pagos, aguardando, em análise, com falha e reembolsados; zona geográfica, valor total mínimo e ordem de exibição. Log opcional sem chaves, dados de cartão ou dados do cliente.

Requisitos

OpenCart 3.0.x (testado na versão 3.0.5.0) ou OpenCart 4.0.2 e versões posteriores (testado na versão 4.1.0.3), PHP 8.0 ou superior, HTTPS. Um único download contém os pacotes para as duas versões. Uma conta OpenPay do México, da Colômbia ou do Peru com seu Merchant ID, chave privada e chave pública (sandbox e produção), e uma moeda de pedido aceita pela conta. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).