VibeFox PagSeguro for OpenCart

Visão geral

O VibeFox PagSeguro Gateway conecta o OpenCart 3 e o OpenCart 4 à API Checkout da PagBank (PagSeguro) para lojas no Brasil. No último passo da finalização de compra, o cliente clica em Confirm Order, é enviado para a página de pagamento da PagBank e paga com os meios ativados na sua conta PagBank, por exemplo cartão de crédito, PIX ou boleto. Os pagamentos são aceitos somente em reais (BRL). O OpenCart cria o pedido antes do pagamento, mas o pedido só recebe um status depois que a PagBank informa o pagamento; por isso, as tentativas não pagas continuam como pedidos ausentes.

Ela é indicada para lojas brasileiras que querem a página de pagamento hospedada da PagBank, com reembolsos pela página do pedido no OpenCart. A extensão não tem formulário de cartão no site, nem cartões salvos, assinaturas ou pagamentos recorrentes, nem pagamentos divididos. Os meios de pagamento e os parcelamentos são os configurados na sua conta PagBank.

Principais recursos

Página de pagamento da PagBank: um único checkout pelo total do pedido em BRL. A página de pagamento expira em 120 minutos.

Pago somente quando a PagBank confirma: as notificações e o retorno do cliente apenas disparam uma verificação. O checkout, o pedido na PagBank e suas cobranças são sempre lidos pela API da PagBank com o token do ambiente em que o pagamento foi criado.

Notificações assinadas: quando a PagBank envia o cabeçalho x-authenticity-token, ele é conferido com o seu token; uma assinatura inválida é recusada.

Conferência de valor e moeda: o valor cobrado (sem os juros do parcelamento da PagBank) e a moeda são comparados com o pedido. Uma divergência ou um pagamento feito após o cancelamento coloca o pedido em um status de revisão, com uma observação.

Boleto, PIX e análise: um boleto ou PIX gerado, ou um pagamento em análise, coloca o pedido em um status de aguardando até que a PagBank informe o pagamento como pago.

Um carrinho, um pagamento: quando o cliente paga novamente, o checkout aberto na PagBank é reaproveitado ou desativado antes. Um pagamento feito em uma página anterior continua valendo, e um segundo pagamento é sinalizado para reembolso.

Reembolsos pela página do pedido: reembolsos totais e parciais na aba VibeFox PagSeguro Gateway do pedido, até o valor efetivamente cobrado pela PagBank. Reembolsos feitos no painel da PagBank são registrados no pedido.

Sandbox e produção: tokens separados. As consultas de status e os reembolsos sempre usam o ambiente do pagamento. Seus próprios status de pedido do OpenCart para cada caso.

Requisitos

OpenCart 3.0.x (testado na versão 3.0.5.0) ou OpenCart 4.0.2 e superior (testado na versão 4.1.0.3), PHP 8.0 ou superior. Um único download contém os pacotes das duas versões. A moeda Real Brasileiro (BRL) na sua loja. Uma conta PagBank com token de produção e um token de sandbox para testes. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).