VibeFox OpenPay for PrestaShop

Visão geral

O VibeFox OpenPay Gateway adiciona ao PrestaShop pagamentos com cartão de crédito e débito pela OpenPay (BBVA), para contas OpenPay do México, da Colômbia e do Peru. O cliente digita o cartão na etapa de pagamento, mas o cartão é tokenizado no navegador pela biblioteca openpay.js, então o número do cartão e o CVV nunca chegam à sua loja. Cada pagamento passa pelo 3D Secure, e o pedido só é criado depois que a OpenPay confirma o pagamento.

O módulo aceita pagamentos únicos com cartão, com captura imediata. Não tem cartões salvos, assinaturas, parcelamento sem juros (MSI) ou em parcelas, pagamento com pontos do cartão, dinheiro, SPEI, PSE ou CoDi, nem autorização e captura separadas.

Principais recursos

Formulário de cartão com 3D Secure: formulário de cartão na etapa de pagamento, tokenizado pelo openpay.js com a verificação antifraude do dispositivo da OpenPay; cada cobrança passa pelo 3D Secure.

Pago somente quando a OpenPay confirma: a cobrança é relida da API da OpenPay quando o cliente volta do 3D Secure e quando chega o webhook.

Verificação de valor e moeda: uma cobrança concluída precisa corresponder exatamente ao total do carrinho e à moeda. Se não corresponder, o pedido vai para OpenPay payment on hold com uma nota, sem ser marcado como pago.

Nunca cobrado duas vezes: um carrinho com pedido nunca é cobrado novamente, e antes de uma nova tentativa a cobrança anterior do carrinho é verificada.

Sandbox e produção: Merchant ID, chave privada e chave pública separados para cada modo. Reembolsos e webhooks sempre usam as chaves do modo e do país da conta em que a cobrança foi feita.

Reembolsos na tela do pedido: reembolsos totais e parciais no bloco OpenPay payment para México e Peru (Colômbia: no painel da OpenPay). Reembolsos e contestações feitos no painel da OpenPay são anotados no pedido.

Mensagens claras ao cliente: cartão vencido, saldo insuficiente, CVV incorreto, falha no 3D Secure e outros erros da OpenPay recebem mensagens curtas; erros técnicos nunca são mostrados aos clientes.

Bloco da OpenPay na tela do pedido: ID da cobrança, status, histórico de reembolsos e as notas da OpenPay do pedido. Registro opcional, sem chaves, dados de cartão ou dados do cliente.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 ou superior, HTTPS. Uma conta OpenPay do México, da Colômbia ou do Peru com o Merchant ID, a chave privada e a chave pública do sandbox e da produção. Uma chave de licença VibeFox de vibefox.net (uma chave por domínio).