VibeFox IntaSend for OpenCart

Visão geral

O VibeFox IntaSend Pay Gateway adiciona pagamentos IntaSend ao OpenCart 3 e ao OpenCart 4 para lojas no Quênia e na África Oriental. Na última etapa da finalização de compra, o cliente clica em Confirm Order, é enviado para a página de pagamento hospedada pela IntaSend, paga com M-Pesa, cartão ou outro método ativado na sua conta IntaSend, e volta para a sua loja. O OpenCart cria o pedido antes do pagamento, mas o pedido só recebe um status depois que a IntaSend confirma o pagamento; por isso, tentativas não pagas ficam como pedidos ausentes.

Ele é indicado para lojas que querem aceitar M-Pesa e cartões com uma conta IntaSend, sem um formulário de pagamento no próprio site. A extensão aceita apenas pagamentos únicos. Os reembolsos não são enviados à IntaSend pela loja, e não há cartões salvos, assinaturas nem formulário de pagamento embutido (pop-up).

Principais recursos

Checkout hospedado da IntaSend: um pagamento pelo total do pedido na moeda do pedido. Moedas suportadas: KES, USD, EUR, GBP, UGX, TZS, NGN, GHS, XAF e XOF. UGX, XAF e XOF são enviadas sem casas decimais.

Pago somente quando a IntaSend confirma: o status do pedido só é definido depois que o seu servidor consulta a API de status de pagamento da IntaSend com a sua chave secreta. Nada enviado pelo navegador ou no corpo do webhook é considerado confiável. Em seguida, o OpenCart envia os e-mails habituais do pedido.

Webhook com challenge: os pagamentos são confirmados mesmo quando o cliente fecha o navegador ou o M-Pesa confirma depois. Webhooks com challenge incorreto são rejeitados.

Verificação de valor e moeda: o valor e a moeda informados pela IntaSend são comparados com o pedido. Uma divergência ou um pagamento parcial coloca o pedido em um status de análise, com uma observação.

Sem processamento duplicado: um pagamento é aplicado uma única vez, mesmo quando o retorno do cliente e o webhook chegam ao mesmo tempo. Um carrinho é pago uma só vez, e um segundo pagamento é sinalizado com uma observação.

Modos sandbox e ao vivo: pares de chaves separados para cada modo. O método de pagamento fica oculto enquanto as chaves do modo atual estiverem ausentes ou pertencerem ao outro modo. Pagamentos antigos são sempre verificados no modo em que foram feitos.

Mensagens claras: uma mensagem após um pagamento com falha ou abandonado, e uma página de «confirmação em andamento» com o botão Check again enquanto o M-Pesa ainda está confirmando.

Condições do OpenCart e aba no pedido: zona geográfica, total mínimo do pedido, ordem de exibição e os seus próprios status de pedido. A página do pedido tem uma aba com as tentativas e as faturas da IntaSend. O log não contém chaves nem dados de clientes.

Requisitos

OpenCart 3.0.x (testado na versão 3.0.5.0) ou OpenCart 4.0.2 e superior (testado na versão 4.1.0.3), PHP 8.0 ou superior com cURL. Um único download contém os pacotes para as duas versões. Uma conta IntaSend com chaves de API publicável e secreta, e um webhook com uma frase de challenge. HTTPS para pagamentos ao vivo. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).