VibeFox Conekta for OpenCart

Visão geral

O VibeFox Conekta Gateway adiciona ao OpenCart 3 e ao OpenCart 4 pagamentos pela Conekta (México). No último passo da finalização de compra, o cliente clica em Confirm Order, é enviado à página de pagamento segura e hospedada pela Conekta e paga com cartão de crédito ou débito, em dinheiro na OXXO e em outras lojas, por transferência bancária SPEI ou por BNPL, conforme o que você permitir. Depois, o cliente volta para a sua loja. Os dados do cartão nunca passam pelo seu site. O OpenCart cria o pedido antes do pagamento, mas o pedido só recebe um status depois que a Conekta confirma o pagamento ou emite uma referência OXXO ou SPEI, por isso as tentativas não pagas continuam como pedidos ausentes.

Ela é indicada para lojas mexicanas que vendem em MXN ou USD e querem oferecer pagamentos com cartão e em dinheiro em um único método, com uma conta na Conekta. A extensão aceita apenas pagamentos únicos. Não há formulário de cartão na página de finalização de compra e não há cartões salvos, assinaturas, pré-autorização com captura nem parcelamento sem juros (MSI). Reembolsos ou contestações feitos no painel da Conekta são apenas registrados no pedido, não são gravados automaticamente.

Principais recursos

Checkout hospedado da Conekta: é criado um pedido na Conekta pelo total do pedido, na moeda do pedido, com produtos, descontos, impostos e frete. Dinheiro, SPEI e BNPL são oferecidos para pedidos em MXN; pedidos em USD aceitam apenas cartões.

Pago somente quando a Conekta confirma: tanto o webhook quanto o retorno do cliente apenas disparam a leitura do pedido na API da Conekta com a sua chave privada. Nada em uma notificação ou na URL de retorno é considerado confiável. Depois, o OpenCart envia os e-mails habituais do pedido.

Verificação de valor e moeda: o valor em centavos e a moeda são comparados com o pedido. Qualquer diferença, ou um pagamento em modo de teste recebido com a loja em modo real, coloca o pedido no seu status de retenção para análise.

OXXO e SPEI: quando o cliente recebe uma referência de pagamento, o pedido recebe o seu status de aguardando pagamento e muda para o status de pago quando a Conekta informa o pagamento.

Sem processamento duplicado: notificações repetidas ou simultâneas nunca aplicam um pagamento duas vezes. Antes de uma nova tentativa, os checkouts anteriores da Conekta do carrinho são reutilizados, confirmados se já estiverem pagos ou cancelados, de modo que um link antigo não possa ser pago duas vezes.

Modos de teste e real: chaves privadas separadas para cada modo e um aviso de MODO DE TESTE na finalização de compra. Notificações e reembolsos sempre usam a chave do modo em que o pagamento foi feito.

Reembolsos pela página do pedido: reembolsos totais e parciais na aba VibeFox Conekta Gateway do pedido, até o valor que a Conekta realmente cobrou. Um reembolso total define o status Refunded.

Condições do OpenCart: seus próprios status de pedido, zona geográfica, valor total mínimo do pedido e ordem de exibição. Registro opcional, sem chaves de API nem dados de contato do cliente.

Requisitos

OpenCart 3.0.x (testado na 3.0.5.0) ou OpenCart 4.0.2 e superior (testado na 4.1.0.3), PHP 8.0 ou superior. Um único download contém os pacotes das duas versões. Moeda da finalização de compra MXN ou USD. Uma conta na Conekta com chaves privadas de teste e de produção e um webhook no painel da Conekta. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).