VibeFox Culqi for OpenCart

Visão geral

O VibeFox Culqi Payment adiciona ao OpenCart 3 e ao OpenCart 4 o Culqi, o serviço de pagamento do Peru. Na última etapa da finalização de compra, o cliente clica em Confirm Order e paga com cartão ou Yape na janela pop-up Culqi Checkout, sem sair da sua loja. Os dados do cartão são digitados na janela do Culqi e nunca chegam ao seu servidor. Em seguida, o seu servidor cria a cobrança pela API de cobranças do Culqi (Culqi Charges API). O OpenCart cria o pedido antes do pagamento, mas o pedido só recebe um status depois que o Culqi confirma a cobrança; por isso, pagamentos recusados ou abandonados ficam como pedidos ausentes.

Ele é indicado para lojas do Peru que vendem em sol peruano (PEN) ou dólar americano (USD) e têm uma conta no Culqi. A extensão aceita apenas pagamentos únicos com cartão e Yape. Não há app bancário, agentes, carteiras ou Cuotéalo, nem cartões salvos, assinaturas ou parcelamentos, nem webhooks do Culqi, nem autorização e captura separadas.

Principais recursos

Pop-up Culqi Checkout: cartões (Visa, Mastercard, American Express, Diners Club) e, opcionalmente, Yape em uma janela na etapa de confirmação da sua finalização de compra.

3-D Secure: quando o banco exige, o Culqi 3-D Secure abre automaticamente e a cobrança é concluída após a autenticação.

Pago somente quando o Culqi confirma: o status do pedido é definido depois que o Culqi responde com uma cobrança bem-sucedida, e o valor cobrado e a moeda são comparados com o pedido. Uma divergência coloca o pedido em um status de revisão com uma observação. Depois, o OpenCart envia os e-mails habituais de pedido.

Sem cobranças duplicadas: um pedido que já tem uma cobrança do Culqi nunca é cobrado novamente, mesmo após um clique duplo, uma segunda aba ou uma nova tentativa.

Recusas claras: o cliente vê a mensagem do Culqi e pode tentar outro cartão na mesma etapa. Uma observação no pedido e o log guardam o código da recusa.

Modos de teste e de produção: chaves públicas e secretas separadas para cada modo. Os reembolsos sempre usam as chaves do modo em que o pagamento foi feito.

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

Condições do OpenCart e configurações seguras: zona geográfica, valor mínimo do pedido, ordem de exibição e os seus próprios status de pedido. Chaves com prefixo incorreto são recusadas, e as chaves secretas salvas nunca mais são exibidas. Log opcional, sem chaves, dados de cartão ou dados de clientes.

Requisitos

OpenCart 3.0.x (testado na versão 3.0.5.0) ou OpenCart 4.0.2 e posterior (testado na versão 4.1.0.3), PHP 8.0 ou posterior. Um único download contém os pacotes das duas versões. Uma moeda da loja ativada: PEN ou USD. Uma conta no Culqi com chaves de API pública e secreta. Uma chave de licença VibeFox de vibefox.net (uma chave por domínio).