VibeFox Pagar.me for PrestaShop

Visão geral

O VibeFox Pagar.me Gateway conecta o PrestaShop à Core API v5 da Pagar.me (Stone) para lojas no Brasil. Na etapa de pagamento, o cliente escolhe a Pagar.me, é levado à página de pagamento da Pagar.me e paga com cartão de crédito, PIX, boleto ou cartão de débito. Os dados do cartão nunca passam pela sua loja. Os pagamentos são aceitos somente em real brasileiro (BRL). O pedido só é criado depois que a Pagar.me confirma o pagamento ou emite um PIX ou boleto, então pagamentos abandonados não deixam pedidos sem pagamento.

Ele é indicado para lojas brasileiras que querem oferecer os principais meios de pagamento locais em uma única página hospedada, com reembolsos pela página de pedidos do PrestaShop. O módulo não tem formulário de cartão no seu checkout, nem cartões salvos, assinaturas ou cobranças recorrentes, nem regras de parcelamento, nem pagamentos divididos, nem pagamentos com cartão apenas de autorização e nenhuma integração com o Pagar.me Hub.

Principais recursos

Página de pagamento da Pagar.me: cartão de crédito, PIX, boleto e cartão de débito. Você escolhe quais métodos são oferecidos e por quantos dias um boleto é válido (de 1 a 30).

Pago somente quando a Pagar.me confirma: o webhook e o retorno do cliente apenas informam à loja qual pedido da Pagar.me deve ser verificado. O pedido é então lido pela API da Pagar.me com a sua chave secreta.

Verificação de valor e moeda: o valor das cobranças pagas é comparado ao total do carrinho. Uma diferença, um boleto pago parcialmente ou um pagamento após o cancelamento colocam o pedido em Pagar.me payment on hold, com uma nota.

PIX e boleto: um PIX ou boleto emitido cria o pedido em Awaiting Pagar.me payment até que a Pagar.me confirme o pagamento. Um expirado coloca o pedido em Payment error.

Novas tentativas seguras: quando o cliente paga novamente, a página de pagamento aberta é reaproveitada ou fechada antes na Pagar.me. Um pagamento feito em uma página anterior continua associado ao carrinho, e um segundo pagamento é sinalizado para reembolso.

Reembolsos pela página do pedido: reembolsos totais e parciais de pagamentos com cartão e PIX no bloco Pagar.me payment, até o valor que a Pagar.me efetivamente cobrou. Reembolsos e contestações feitos na Pagar.me aparecem no pedido.

Teste e produção: chaves secretas separadas para teste e produção. As consultas de status e os reembolsos sempre usam a chave do modo em que o pagamento foi criado.

Bloco da Pagar.me na página do pedido: o pedido na Pagar.me, o meio de pagamento, o status, os valores pagos e reembolsados, o histórico de reembolsos e as notas da Pagar.me do pedido. Registro opcional, sem chaves nem dados de clientes.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 ou superior. Moeda da loja: real brasileiro (BRL). Uma conta na Pagar.me com as chaves secretas de teste e de produção e um webhook. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).