VibeFox Conekta for PrestaShop

Visão geral

O VibeFox Conekta Gateway adiciona ao PrestaShop pagamentos pela Conekta (México). Na etapa de pagamento, o cliente escolhe a Conekta, é direcionado à página de pagamento segura 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 com BNPL, conforme os métodos que você permitir. Em seguida, o cliente volta para a sua loja. Os dados do cartão nunca chegam ao seu site. O pedido só é criado depois que a Conekta confirma o pagamento ou emite uma referência OXXO ou SPEI, por isso pagamentos abandonados não deixam pedidos sem pagamento.

Ele é indicado para lojas mexicanas que vendem em MXN ou USD e querem aceitar cartões e pagamentos em dinheiro em um único método, com uma conta Conekta. O módulo aceita somente pagamentos únicos. Não há formulário de cartão na sua página de pagamento, nem cartões salvos, assinaturas, pré-autorização e captura ou parcelamento mensal (MSI), e reembolsos ou chargebacks feitos no painel da Conekta são apenas anotados no pedido, sem serem registrados automaticamente.

Principais recursos

Página de pagamento hospedada pela Conekta: um pedido na Conekta é criado pelo total do carrinho na moeda do carrinho. Dinheiro, SPEI e BNPL são oferecidos para carrinhos em MXN; carrinhos 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.

Verificação de valor e moeda: o valor em centavos e a moeda são comparados com o carrinho. Qualquer diferença, ou um pagamento em modo de teste recebido enquanto a loja está em modo de produção, coloca o pedido em Conekta payment on hold para revisão.

OXXO e SPEI: quando o cliente recebe uma referência de pagamento, o pedido é criado como Awaiting Conekta payment e passa para Payment accepted quando a Conekta informa o pagamento.

Sem processamento duplicado: notificações repetidas ou simultâneas nunca criam um segundo pedido nem registram o pagamento duas vezes. Uma página de pagamento da Conekta ainda aberta é reutilizada ou cancelada antes de ser criada uma nova, para que um link antigo não possa ser pago duas vezes.

Modos de teste e de produção: chaves privadas separadas para cada modo e um aviso TEST MODE na finalização de compra. Reembolsos e notificações sempre usam a chave do modo em que o pagamento foi feito.

Reembolsos pela página do pedido: reembolsos totais e parciais no bloco Conekta payment do pedido, até o valor que a Conekta de fato cobrou. Um reembolso total coloca o pedido em Refunded.

Bloco da Conekta na página do pedido: o pedido na Conekta, a cobrança, o status, os valores, o histórico de reembolsos e as notas do módulo. Log opcional, sem chaves de API nem dados de contato do cliente.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 ou superior. Moeda do carrinho MXN ou USD. Uma conta 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).