VibeFox Culqi for PrestaShop

Visão geral

O VibeFox Culqi Payment adiciona ao PrestaShop a Culqi, o serviço de pagamentos peruano. Na etapa de pagamento, o cliente paga com cartão ou Yape no pop-up do Culqi Checkout e nunca sai da sua loja. Os dados do cartão são digitados na janela da Culqi e nunca chegam ao seu servidor. Em seguida, o seu servidor cria a cobrança com a Culqi Charges API, e o pedido só é criado depois que a Culqi confirma a cobrança. Assim, pagamentos recusados ou abandonados não geram pedidos sem pagamento.

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

Principais recursos

Pop-up do Culqi Checkout: cartões (Visa, Mastercard, American Express, Diners Club) e, opcionalmente, Yape em uma janela na sua página de 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 a Culqi confirma: o pedido é criado quando a Culqi responde com uma cobrança bem-sucedida, e o valor e a moeda cobrados são comparados com o carrinho. Se houver divergência, o pedido passa para Culqi payment on hold, com uma nota.

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

Recusas claras: o cliente vê a mensagem da Culqi e pode tentar outro cartão. O código da recusa é registrado no log do módulo.

Modos de teste e produção: chaves pública e secreta 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 no bloco Culqi payment do pedido, até o valor que a Culqi realmente cobrou. Um reembolso total coloca o pedido em Refunded.

Configurações seguras e log: chaves com prefixo errado são recusadas, e as chaves secretas salvas nunca são exibidas novamente. Log opcional sem chaves, dados do cartão ou dados do cliente.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 ou superior. Moeda da loja PEN ou USD. Uma conta na Culqi com chaves de API pública e secreta. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).