VibeFox Peach Payments for PrestaShop

Visão geral

O VibeFox Peach Payments Pay Gateway adiciona pagamentos com cartão pela Peach Payments ao PrestaShop. Ele se conecta à Peach Payments Card API (COPYandPAY). Na etapa de pagamento, o cliente escolhe o pagamento com cartão e informa os dados do cartão no formulário da Peach Payments, em uma página de pagamento da sua loja. Os dados são digitados no formulário da Peach Payments e nunca chegam ao seu servidor. Visa, Mastercard, American Express e Diners Club são aceitos. O pedido só é criado depois que a Peach Payments confirma o pagamento, então pagamentos abandonados não deixam pedidos sem pagamento.

É indicado para lojas na África do Sul, no Quênia e em Maurício que vendem em ZAR, KES ou MUR e têm uma conta Peach Payments. O módulo não oferece reembolsos pela página de pedidos do PrestaShop (reembolse no painel da Peach Payments), cartões salvos, assinaturas, pré-autorização e captura, nem EFT, BNPL, QR ou outros métodos sem cartão.

Principais recursos

Pago somente quando a Peach Payments confirma: o redirecionamento do navegador nunca cria sozinho um pedido pago. Quando o cliente retorna, a loja consulta o resultado da finalização de compra desse carrinho na API da Peach Payments, de servidor para servidor.

Webhooks criptografados: os webhooks da Peach Payments Card (AES-256-GCM) confirmam os pagamentos mesmo que o cliente feche o navegador antes de retornar. Se o carrinho estiver ocupado, o webhook recebe um erro temporário e a Peach Payments o envia novamente.

Verificação de valor e moeda: cada pagamento é comparado ao carrinho. Uma divergência coloca o pedido no status Peach Payments payment on hold, com uma nota, em vez de marcá-lo como pago.

Sem processamento duplicado: webhooks repetidos, recarregamentos de página ou um webhook simultâneo ao retorno do cliente nunca criam um segundo pedido nem registram o pagamento duas vezes. Um segundo pagamento de um pedido já pago é sinalizado para reembolso.

Modos de teste e produção: Entity ID, Access Token e chave de webhook separados para o sandbox da Peach Payments e para a conta de produção. Um pagamento é sempre verificado no modo em que foi iniciado.

Operações do painel como notas: reembolsos, estornos e contestações feitos no painel da Peach Payments são adicionados às notas do pedido pelo webhook.

Bandeiras de cartão: escolha as bandeiras exibidas no formulário de pagamento. O script do formulário é carregado com um hash de Subresource Integrity.

Bloco da Peach Payments na página do pedido: ID do pagamento, ID do checkout, valor, resultado e notas do módulo. Log opcional sem dados de cartão, chaves ou dados do cliente.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 ou superior com a extensão OpenSSL. Uma conta Peach Payments com Entity ID e Access Token da Card API (teste e/ou produção) e a chave de descriptografia dos webhooks fornecida pela Peach Payments. Moeda do carrinho: ZAR, KES ou MUR. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).