VibeFox PagSeguro for PrestaShop

Visão geral

O VibeFox PagSeguro Gateway conecta o PrestaShop ao PagBank (antes PagSeguro) com a PagBank Checkout API. Na etapa de pagamento, o cliente escolhe o PagBank; o módulo cria um checkout no PagBank pelo valor exato do carrinho e envia o cliente para a página de pagamento do PagBank. Lá ele paga com os métodos habilitados na sua conta do PagBank, como cartão de crédito, PIX ou boleto, e volta para a sua loja. Os pagamentos são aceitos somente em reais (BRL). O pedido só é criado depois que o PagBank informa o pagamento, então pagamentos abandonados não geram pedidos sem pagamento.

Ele é indicado para lojas brasileiras que querem a página de pagamento hospedada do PagBank com reembolsos feitos diretamente na página do pedido no PrestaShop. O módulo não tem formulário de cartão na loja, não guarda cartões, não oferece assinaturas nem cobranças recorrentes e não faz pagamentos divididos. Os métodos de pagamento e os parcelamentos são os configurados na sua conta do PagBank; eles não são escolhidos no módulo.

Principais recursos

Página de pagamento hospedada no PagBank: nenhum dado de cartão fica no seu servidor. Nome, e-mail, telefone brasileiro e CPF/CNPJ do cliente são preenchidos na página do PagBank quando a loja os tem.

Pago somente quando o PagBank confirma: as notificações e o retorno do cliente são verificados lendo o checkout e o pedido no PagBank pela API: status, valor em centavos e moeda. Notificações com assinatura inválida são rejeitadas.

Nada para configurar no PagBank: a URL de notificação é enviada com cada pagamento.

Verificação de valor: um pagamento cujo valor ou moeda não corresponda ao carrinho vai para PagBank payment on hold com uma nota. Os juros do parcelamento pagos pelo comprador são considerados.

Status claros: pedidos pagos vão para Payment accepted; PIX ou boletos gerados e pagamentos em análise vão para Awaiting PagBank payment; pagamentos recusados depois vão para Payment error, e os cancelados, para Canceled.

Sem pagamento duplicado: pagar de novo reaproveita o checkout aberto no PagBank ou desativa o anterior. Notificações e retornos repetidos nunca criam um segundo pedido nem registram o pagamento duas vezes.

Sandbox e produção: tokens separados. As consultas de status e os reembolsos de um pedido sempre usam o ambiente em que o pagamento foi feito.

Reembolsos pela página do pedido: reembolsos totais e parciais no bloco PagBank payment, até o valor cobrado pelo PagBank, registrados somente quando o PagBank os confirma. Um reembolso total coloca o pedido em Refunded.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 ou superior. Real brasileiro (BRL) como moeda do carrinho. Uma loja acessível pela internet por HTTPS. Uma conta do PagBank com token de produção e um token de sandbox para os testes. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).