VibeFox Pagar.me for OpenCart

Visão geral

O VibeFox Pagar.me Gateway conecta o OpenCart 3 e o OpenCart 4 à Core API v5 da Pagar.me (Stone) 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 Pagar.me e paga com cartão de crédito, PIX, boleto ou cartão de débito. 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 Pagar.me confirma o pagamento ou gera um PIX ou boleto; por isso, as tentativas não pagas continuam como pedidos ausentes.

Ela é indicada para lojas brasileiras que querem oferecer os principais meios de pagamento locais em uma única página hospedada, com reembolsos pela página do pedido no OpenCart. A extensão não tem formulário de cartão dentro da sua finalização de compra, nem cartões salvos, assinaturas ou pagamentos recorrentes, nem regras de parcelamento, nem pagamentos divididos, nem pagamentos com cartão somente de autorização.

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 meios 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 indicam à loja qual pedido da Pagar.me deve ser verificado. Depois, o pedido é lido pela API da Pagar.me com a sua chave secreta.

Conferência de valor e moeda: os valores cobrados são comparados com o total do pedido. Uma diferença, um boleto pago a menos ou um pagamento feito após o cancelamento coloca o pedido em um status de revisão, com uma observação.

PIX e boleto: um PIX ou boleto gerado coloca o pedido em um status de aguardando até que a Pagar.me confirme o pagamento. Um PIX ou boleto vencido define o status de falha.

Um carrinho, um pagamento: quando o cliente paga novamente, a página de pagamento aberta é reaproveitada ou fechada na Pagar.me antes. Um segundo pagamento do mesmo carrinho é sinalizado para reembolso.

Reembolsos pela página do pedido: reembolsos totais e parciais de pagamentos com cartão e PIX na aba VibeFox Pagar.me Gateway do pedido, até o valor que a Pagar.me efetivamente cobrou. Reembolsos e chargebacks feitos na Pagar.me são registrados 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.

Seus próprios status de pedido: escolha o status do OpenCart para um pedido pago, um PIX ou boleto aguardando, um pagamento em revisão, um pagamento com falha e um reembolso.

Requisitos

OpenCart 3.0.x (testado na versão 3.0.5.0) ou OpenCart 4.0.2 e posteriores (testado na versão 4.1.0.3), PHP 8.0 ou superior. O download contém os pacotes para as duas versões. A moeda Real Brasileiro (BRL) na sua loja. 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).