VibeFox Pagar.me for OpenCart — Ajuda
Requisitos
OpenCart: 3.0.x (testado na versão 3.0.5.0) ou 4.0.2 e posteriores (testado na versão 4.1.0.3).
PHP: 8.0 ou posterior.
Currency: Real brasileiro (BRL). A loja deve ter a moeda BRL (System > Localisation > Currencies), e o método de pagamento só é exibido quando o cliente finaliza a compra em BRL e o total do pedido é maior que zero.
Pagar.me account: você precisa das chaves secretas da sua conta Pagar.me: a chave de teste (sk_test_...) e, para ir para produção, a chave de produção (sk_...). Elas ficam no painel da Pagar.me, em Development > Keys. Só as chaves secretas são usadas; a chave pública (pk_...) não é necessária. Só é possível oferecer os métodos de pagamento habilitados na sua conta Pagar.me.
VibeFox license key: adquirida em vibefox.net. Uma chave funciona em um único domínio.
Instalação
O download é um único arquivo zip com os pacotes para as duas versões do OpenCart. Descompacte-o no seu computador. Ele contém o README.txt, o pacote do OpenCart 3 wcp_pagarme_gateway-oc3-(version).ocmod.zip e o pacote do OpenCart 4 wcp_pagarme_gateway.ocmod.zip. Instale somente o pacote da sua versão do OpenCart. A chave de licença é a mesma para as duas versões.
OpenCart 3
1. No painel administrativo, acesse Extensions > Installer, clique em Upload e escolha o arquivo wcp_pagarme_gateway-oc3-(version).ocmod.zip. A extensão não tem modificações OCMOD, então Extensions > Modifications não precisa ser atualizado. Em vez do instalador, você também pode copiar o conteúdo da pasta upload deste pacote para a pasta raiz da sua loja.
2. Acesse Extensions > Extensions e escolha o tipo Payments. Localize VibeFox Pagar.me Gateway e clique em Install (o botão verde +). Seu usuário administrador precisa do direito de modificar a lista de extensões de pagamento.
3. Clique em Edit (o botão com o lápis) para abrir a página de configurações. Cole sua chave de licença VibeFox em License key, no bloco de licença no topo da página, e clique em Activate (veja Chave de licença).
4. Informe a chave secreta de teste e, quando for para produção, a chave secreta de produção.
5. Crie o webhook no painel da Pagar.me com a URL exibida nas configurações (veja Configuração).
6. Ative Enable / Disable e clique em Save. Faça pagamentos de teste com Test mode ativado e depois desative-o para receber pagamentos reais.
OpenCart 4
1. No painel administrativo, acesse Extensions > Installer, clique em Upload e escolha o arquivo wcp_pagarme_gateway.ocmod.zip. Não renomeie o arquivo: o OpenCart 4 obtém o código da extensão a partir do nome do arquivo, e um pacote renomeado não funciona.
2. O pacote aparece na lista de extensões instaladas, na mesma página. Clique em Install (o botão verde +) ao lado dele.
3. Acesse Extensions > Extensions e escolha o tipo Payments. Localize VibeFox Pagar.me Gateway, clique em Install (o botão verde +) e depois em Edit (o botão com o lápis).
4. Informe a chave de licença, as chaves secretas e o webhook como nas etapas 3 a 6 do OpenCart 3. A página de configurações e seus campos são iguais nas duas versões. Só a URL do webhook é diferente (veja Notificações de pagamento (webhook)).
Uma instalação nova começa com o método de pagamento desativado e o modo de teste ativado.
Configuração
Todas as configurações estão na página da extensão: Extensions > Extensions > Payments > VibeFox Pagar.me Gateway > Edit. As seções aparecem à esquerda; o botão Save abaixo da lista salva a página inteira. Acima das configurações, a página mostra o modo atual: TEST MODE (os pagamentos são criados com a chave secreta de teste, sem cobranças reais) ou LIVE. Ela avisa quando falta a chave secreta do modo atual (nesse caso o método de pagamento fica oculto na finalização da compra), quando a chave de teste não começa com sk_test_, quando a chave de produção não começa com sk_ ou é uma chave de teste, e quando a moeda padrão da loja não é BRL. Sem o direito de modificar a extensão, a página mostra as configurações, mas não consegue salvá-las.
Ao salvar, Title não pode ficar vazio (até 128 caracteres), Boleto due in (days) deve ser um número inteiro de 1 a 30, Sort Order deve ser um número inteiro (números negativos são permitidos), Total deve ser um número igual ou maior que 0, e a zona geográfica e os status de pedido devem existir. Se um valor estiver errado, uma mensagem o indica e nada é salvo.
Pagar.me
Enable / Disable: Enable Pagar.me payments ativa ou desativa o método de pagamento. Padrão: desativado.
Title: o nome do método de pagamento que os clientes veem na finalização da compra. Também é o nome do método de pagamento salvo no pedido. Padrão: Pagar.me. Obrigatório, até 128 caracteres.
Description: o texto exibido ao cliente na etapa Confirm Order, acima do botão de confirmação. Padrão: Pague com segurança via Pagar.me (cartão de crédito, PIX ou boleto). Você será redirecionado para concluir seu pagamento.
Sort Order: a posição do Pagar.me entre os métodos de pagamento na finalização da compra. Deixe em branco ou informe um número inteiro.
Geo Zone: oferecer o Pagar.me apenas para endereços de pagamento da zona geográfica selecionada. Padrão: All zones. As zonas geográficas são configuradas em System > Localisation > Geo Zones. No OpenCart 4, quando a loja não solicita endereço de pagamento, é usado o endereço de entrega.
Total: o total da compra, na moeda padrão da loja, que um pedido deve atingir antes de o Pagar.me ser oferecido. Deixe em branco para oferecer o Pagar.me para qualquer total.
Chaves de API
Copie as chaves secretas do painel da Pagar.me (a seção tem um link para ele): Development > Keys. A Pagar.me usa um único endereço de API para pagamentos de teste e de produção; é a chave que define se um pagamento é de teste ou real.
Test mode: usa a chave secreta de teste, sem cobranças reais. Enquanto estiver ativado, os clientes veem TEST MODE — Use test credentials. No real charges. na etapa Confirm Order. As consultas de status e os reembolsos de um pedido sempre usam a chave do modo em que o pagamento dele foi criado. Padrão: ativado.
Test secret key: a chave secreta de teste da Pagar.me (sk_test_...). Usada enquanto o modo de teste estiver ativado.
Live secret key: a chave secreta de produção da Pagar.me (sk_...). Usada quando o modo de teste estiver desativado. Mantenha-a em sigilo.
As chaves salvas nunca são exibidas novamente. O campo fica vazio e mostra Saved — leave empty to keep it. Digite um novo valor apenas para alterá-lo. Para remover uma chave salva, marque Clear the saved key on save abaixo do campo e clique em Save.
Página de pagamento
Os métodos oferecidos na página de pagamento da Pagar.me, cada um com seu próprio interruptor. Escolha apenas métodos habilitados na sua conta Pagar.me. Se nenhum for selecionado, são oferecidos cartão de crédito, PIX e boleto. Padrão: cartão de crédito, PIX e boleto.
Boleto due in (days): o número de dias até o vencimento do boleto, de 1 a 30. Padrão: 3. Outro valor é recusado ao salvar, com Boleto due in (days): enter a number from 1 to 30.
Notificações de pagamento (webhook)
No painel da Pagar.me, abra Settings > Webhooks e crie um webhook com a URL exibida em Webhook URL nesta seção. No OpenCart 3 ela tem o formato https://your-store/index.php?route=extension/payment/wcp_pagarme_gateway/webhook, e no OpenCart 4 o formato https://your-store/index.php?route=extension/wcp_pagarme_gateway/payment/wcp_pagarme_gateway.webhook. Ela é formada a partir do endereço da vitrine da sua instalação do OpenCart. Copie-a exatamente como as configurações a exibem. A URL precisa estar acessível pela Internet.
Selecione estes eventos (eles também estão listados nesta seção):
O webhook não exige senha nem assinatura. Seu conteúdo nunca é considerado confiável: a loja usa dele apenas o ID do pedido da Pagar.me e lê esse pedido na API da Pagar.me com a chave do modo em que ele foi criado. Notificações de pedidos da Pagar.me que não foram criados por esta loja são ignoradas. Sem o webhook, pagamentos de PIX e boleto feitos depois só são confirmados quando o cliente retorna à loja.
Pedidos
O OpenCart cria o pedido na etapa Confirm Order sem status (um pedido ausente, missing order). O pedido recebe um status somente depois que a Pagar.me informa o pagamento pelo webhook ou no retorno do cliente; o pedido da Pagar.me é sempre relido pela API. Cada campo abaixo lista os status de pedido do seu OpenCart.
Order Status After Payment: o status definido após um pagamento verificado da Pagar.me. Padrão: Processando.
Awaiting Pagar.me Payment Status: um código PIX ou um boleto foi emitido, ou um pagamento com cartão está em análise; a Pagar.me confirma o dinheiro depois. Padrão: Pendente.
Pagar.me Payment On Hold Status: o pagamento precisa da sua análise (veja Status de pedido). Padrão: Pendente, pois o OpenCart não tem um status Em espera. Você pode criar seu próprio status em System > Localisation > Order Statuses e selecioná-lo aqui.
Payment Failed Status: o pagamento de um pedido aguardando falhou, foi cancelado ou expirou. Se a Pagar.me informar depois que ele foi pago, o pedido recebe o status de após o pagamento. Padrão: Falhou.
Cancelled Order Status: o status que sua loja usa para pedidos cancelados. A extensão não o define: um pagamento da Pagar.me que chegue depois disso coloca o pedido no status de análise. Padrão: Cancelado.
Refunded Status: definido depois que o pagamento é totalmente reembolsado pela página do pedido ou no painel da Pagar.me. Padrão: Reembolsado.
Avançado
Debug log: grava as requisições à API e as notificações no arquivo wc_pgm_debug.log.php, na pasta de logs do OpenCart (storage/logs). O arquivo não pode ser aberto pela web. Erros e avisos são sempre registrados. Chaves e dados do cliente (e-mail, telefone, CPF) não são registrados. Padrão: desativado.
Log: mostra o tamanho e as entradas mais recentes do log. Clique em Clear log para esvaziá-lo.
Delete data on uninstall: quando ativado, desinstalar a extensão remove as configurações do gateway e o log. Os pedidos e os dados de pagamento da Pagar.me (necessários para reembolsos) são sempre mantidos. Padrão: desativado.
Importar / Exportar
Export: Download JSON salva as configurações em um arquivo JSON. As chaves secretas não são exportadas.
Import: cole um JSON exportado anteriormente e clique em Import para restaurar as configurações. As chaves secretas salvas são mantidas.
Finalização da compra
Na etapa Payment Method, o cliente escolhe o método de pagamento (por padrão, Pagar.me). Na etapa Confirm Order, o cliente vê a sua descrição e a observação You will be redirected to the Pagar.me payment page to pay by credit card, PIX, boleto or debit card. O OpenCart cria o pedido nessa etapa, ainda sem status. No OpenCart 4, o cliente escolhe o método de pagamento pelo botão Choose do bloco do método de pagamento, na janela Payment method options, e clica em Confirm Order no final da página de finalização da compra. Quando o cliente clica em Confirm Order, a extensão cria um pedido na Pagar.me pelo total do pedido em BRL e envia o cliente para a página de pagamento da Pagar.me. As linhas do pedido com impostos, frete e outros acréscimos são enviadas como itens; quando o pedido tem desconto (cupom, vale, pontos de recompensa) ou as linhas não batem com o total, é enviada uma linha Order # com o número do pedido pelo total. É obrigatório um e-mail válido.
O nome e o e-mail do cliente são repassados à Pagar.me. O CPF ou CNPJ (11 ou 14 dígitos) é obtido de um campo personalizado do cliente ou do endereço de pagamento cujo nome contém CPF ou CNPJ; o OpenCart não tem esse campo por padrão, então adicione-o em Customers > Custom Fields se quiser repassá-lo. No OpenCart 4, quando a loja não solicita endereço de pagamento, são usados o endereço de entrega e os seus campos personalizados. Também é repassado um número de celular brasileiro. O endereço de cobrança só é repassado para um endereço brasileiro com CEP de 8 dígitos e estado. Sem CPF ou CNPJ, o cliente o informa na página da Pagar.me.
Depois de pagar, o cliente retorna à sua loja. O pedido só é marcado como pago depois que a Pagar.me confirma: a loja lê o pedido da Pagar.me pela API, e o valor pago e a moeda precisam coincidir com o pedido. Em seguida, o pedido recebe seu status da forma padrão do OpenCart, com os e-mails habituais de pedido e a atualização do estoque, e o cliente vê a página de sucesso do pedido do OpenCart. Um PIX ou boleto emitido e ainda não pago coloca o pedido no status de aguardando, e a página também mostra Your Pagar.me payment is awaiting confirmation (PIX / boleto). The order will be confirmed as soon as Pagar.me reports the payment. Para um pedido no status de análise, ela mostra We are confirming your payment with Pagar.me. The order will be updated automatically — please do not pay again. Cada retorno posterior relê o pedido da Pagar.me, de modo que um PIX ou boleto pago nesse meio tempo é aplicado mesmo que o webhook não tenha chegado.
Se o cliente voltar sem pagar, ele retorna à finalização da compra com The Pagar.me payment was not completed. You can try again or choose another payment method. Se o pagamento foi recusado ou cancelado, a mensagem é The Pagar.me payment was declined or canceled. You can try again or choose another payment method. O carrinho é mantido. No OpenCart 4, essas mensagens são exibidas acima da página de finalização da compra. Se o pedido já tiver status e seu pagamento tiver falhado ou expirado, a mensagem é The Pagar.me payment of your order was declined, canceled or has expired. Please place a new order or contact us. Se o carrinho já estiver vazio (por exemplo, o pedido tinha chegado à página de sucesso antes de expirar o seu PIX ou boleto), não há o que pagar na finalização da compra: uma página Payment confirmation informa The Pagar.me payment of order #N was not completed (declined, canceled or expired), so the order will not be shipped. To buy these items, please place a new order. com um botão Continue. Se não foi possível contatar a Pagar.me, uma página Payment confirmation pede ao cliente que não pague novamente e oferece Check again e Back to checkout.
O OpenCart 3 cria um novo pedido sempre que a etapa Confirm Order é exibida. O OpenCart 4 mantém um único pedido para a finalização da compra e o atualiza, então, depois de um pagamento não concluído ou recusado, o cliente paga novamente o mesmo pedido.Antes de um novo pagamento, a extensão verifica as tentativas anteriores do mesmo carrinho: se alguma estiver paga, ou se o seu PIX ou boleto estiver aguardando, o cliente vai para a página de sucesso sem um novo pagamento. Uma página de pagamento da Pagar.me ainda aberta do mesmo pedido é reutilizada se o valor e o modo forem iguais; as demais páginas abertas são fechadas primeiro na Pagar.me. Se um segundo pedido da Pagar.me do carrinho for pago mesmo assim, ele não é aplicado, e uma observação no pedido pago pede que você reembolse a duplicata.
No OpenCart 4, o pedido permanece na finalização da compra até que a página de sucesso seja exibida. Se esse pedido tiver sido fechado nesse meio tempo (por exemplo, se o PIX ou boleto expirou, se o pagamento falhou ou se você cancelou ou reembolsou o pedido), ao clicar em Confirm Order o cliente volta à finalização da compra com Your previous order was cancelled or its payment failed. Please confirm the order again., ou, quando o pedido tinha sido pago antes de você fechá-lo, com This order was closed by the store, so it will not be shipped. Your cart is kept: confirm the order again to pay. O próximo Confirm Order paga um novo pedido. Quando o cliente volta da Pagar.me para um pedido que foi pago e depois fechado por você, ele vê a mesma mensagem na finalização da compra ou, se o carrinho já estiver vazio, uma página com Order #(número) was closed by the store, so it will not be shipped. To buy these items, please place a new order. Se o pedido da finalização da compra já tiver um status e o carrinho agora tiver outros produtos ou quantidades, o cliente é enviado de volta à finalização da compra, e o novo carrinho recebe um novo pedido.
Se a Pagar.me não conseguir iniciar o pagamento, o cliente permanece na etapa Confirm Order com uma mensagem curta, por exemplo Could not connect to Pagar.me. Please try again in a moment., ou com a mensagem da Pagar.me sobre dados de cobrança inválidos. O motivo técnico é gravado no log.
O webhook também funciona enquanto a loja está em modo de manutenção: o OpenCart 3 deixa passar as requisições das extensões de pagamento, e no OpenCart 4 a extensão adiciona uma ação de inicialização (startup) que deixa passar o webhook e o retorno do cliente da Pagar.me.
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 (marketplace) e nem pagamentos com cartão somente de autorização.
Pedidos e reembolsos
Status de pedido
No status (missing order): o cliente foi enviado à Pagar.me e ainda não pagou nem emitiu um PIX ou boleto, ou o pagamento foi recusado. Em Sales > Orders, esses pedidos só aparecem com o filtro Order Status definido como Missing Orders.
No OpenCart 4, um pedido não pago da finalização da compra pode receber o status Voided, que o OpenCart 4 define quando o cliente volta à etapa Confirm Order. A extensão trata esse pedido como um pedido sem status, e um pagamento posterior ainda o confirma.
Order Status After Payment (default Processing): o pagamento foi confirmado. Uma observação mostra o ID do pedido da Pagar.me (or_...) e o método de pagamento.
Awaiting Pagar.me Payment Status (default Pending): um PIX ou boleto foi emitido (ou um pagamento com cartão está em análise) e aguarda pagamento. O pedido passa para Order Status After Payment quando a Pagar.me confirma o pagamento.
Pagar.me Payment On Hold Status (default Pending): o boleto foi pago apenas parcialmente; ou o valor ou a moeda pagos diferem do pedido; ou o pagamento chegou depois que o pedido foi cancelado ou reembolsado; ou foi aberta uma contestação (chargeback) em um pedido pago. A observação explica. Verifique o pedido e atenda-o ou reembolse o pagamento.
Payment Failed Status (default Failed): o pagamento de um pedido aguardando ou retido falhou, ou o seu pedido na Pagar.me foi cancelado ou expirou (por exemplo, um boleto não pago). Se a Pagar.me informar um pagamento depois, o pedido ainda passa para Order Status After Payment.
Refunded Status (default Refunded): o pagamento foi totalmente reembolsado pela extensão, ou reembolsado ou cancelado na Pagar.me.
Cada status da Pagar.me é aplicado uma única vez, de modo que webhooks repetidos ou retornos não adicionam observações nem pagamentos. As observações são entradas do History do pedido que o cliente não vê.
Aba VibeFox Pagar.me Gateway
Em Sales > Orders, abra um pedido pago com a Pagar.me. Na parte inferior da página do pedido, ao lado de History e Additional, a aba VibeFox Pagar.me Gateway mostra o ID do Pagar.me order com o rótulo Test mode para pagamentos de teste, o Payment method, o Status, os valores Paid / refunded, o formulário de reembolso, o histórico de reembolsos e as Pagar.me notes do pedido. A aba é exibida para usuários que têm acesso à extensão.
Reembolsos
Na aba VibeFox Pagar.me Gateway, informe o Amount (o valor ainda não reembolsado é preenchido), opcionalmente um Reason (optional), e clique em Refund via Pagar.me. Confirme a pergunta Refund this amount through Pagar.me? This cannot be undone. Há suporte para reembolsos totais e parciais de pagamentos com cartão e PIX. Você precisa do direito de modificar a extensão (definido em System > Users > User Groups). É possível reembolsar até o valor que a Pagar.me efetivamente cobrou; assim, depois de uma divergência de valor, o limite é o que o cliente pagou, e não o total do pedido. O reembolso é enviado com a chave do modo em que o pagamento foi feito, por isso a chave secreta desse modo precisa estar configurada. Um reembolso só é registrado quando a Pagar.me o confirma; caso contrário, a aba mostra o erro, por exemplo Pagar.me refused the refund: ... ou Pagar.me did not confirm the refund, e nenhum reembolso é registrado. Um reembolso bem-sucedido é incluído no histórico de reembolsos e nas observações, com o ID da cobrança. Um reembolso total define o pedido como Refunded Status sem notificar o cliente e sem devolver produtos ao estoque, como uma alteração manual de status. Um reembolso parcial não altera o status. Os reembolsos ficam disponíveis assim que a Pagar.me informa o pagamento.
Pagamentos por boleto só podem ser reembolsados para a conta bancária do cliente. Reembolse-os no painel da Pagar.me e depois registre o reembolso manualmente no OpenCart. As devoluções de produtos em Sales > Returns não devolvem dinheiro pela Pagar.me.
Um reembolso total ou um cancelamento feito no painel da Pagar.me chega por webhook, define o pedido como Refunded Status e adiciona uma observação. Uma contestação adiciona uma observação e coloca um pedido pago no status de análise.
Chave de licença
A extensão funciona com uma chave de licença VibeFox obtida em vibefox.net. O bloco de licença License — VibeFox Pagar.me Gateway é o primeiro bloco de Extensions > Extensions > Payments > VibeFox Pagar.me Gateway > Edit, acima das configurações. Cole a chave em License key e clique em Activate. Depois disso, o bloco mostra a chave mascarada, o status (por exemplo, a data até a qual a licença está ativa e o seu domínio) e os botões Check now para verificar o status novamente, Change key para informar outra chave e Remove key para remover a chave desta loja. Abaixo deles ficam a linha Product: opencart-payment-pagarme e o link Manage licenses and domains in your account, que abre sua conta em vibefox.net. Apenas usuários administradores com a permissão de modificar a extensão podem trocar a chave. Os textos do bloco seguem o idioma da área administrativa (inglês e russo estão incluídos).
Se a chave não for aceita, o bloco informa o motivo, por exemplo Key not found, This key belongs to another product, Domain limit reached ou License expired on seguido de uma data. Depois de alterar o endereço da loja, ou depois de liberar uma vaga de domínio na sua conta, clique em Check now. Se o servidor de licenças não puder ser acessado, a extensão continua funcionando com o último status conhecido.
Uma chave funciona em um domínio: o endereço da loja definido na configuração do OpenCart. Remover a chave da loja não libera a vaga de domínio. Libere-a na sua conta em vibefox.net.
Sem uma chave ativa, a Pagar.me não é exibida aos clientes na finalização da compra. Se um pagamento for iniciado mesmo assim, o cliente vê This payment method is not available. Please choose another one. Um usuário administrador conectado à área administrativa no mesmo navegador ainda vê o método de pagamento na loja, marcado como (unlicensed — visible to admins only), para que você possa configurar e testar a extensão antes de comprar uma chave. No OpenCart 4 essa prévia não está disponível: a loja não enxerga o login da área administrativa, então, sem uma chave ativa, o método de pagamento fica oculto para todos. Depois de abrir a página Edit uma vez, aparece um lembrete no Dashboard da área administrativa. Feche-o com × para ocultá-lo por 7 dias. Os pedidos existentes não são afetados: pagamentos já iniciados continuam sendo confirmados, e os reembolsos funcionam.
Quando uma licença expira, a extensão continua funcionando, mas atualizações e suporte exigem renovação. O status é verificado novamente de forma automática ao abrir o Dashboard ou a página Edit da área administrativa: uma vez por dia nos primeiros 14 dias após a chave ser informada, depois uma vez por semana. Não é preciso nenhum cron job. Desinstalar a extensão sempre remove a chave de licença e o status da licença.
Solução de problemas
Pagar.me does not appear at checkout: verifique se a licença está ativa, se Enable / Disable está ativado, se a chave secreta do modo atual está definida (Test secret key no modo de teste, Live secret key no modo de produção) e se o cliente finaliza a compra em BRL. A página de configurações mostra um aviso quando a chave está ausente. Verifique também se o endereço de pagamento está na Geo Zone selecionada e se o pedido atinge o Total definido nas configurações.
The payment went through, but the order stays without a status or in the awaiting status: o webhook não está funcionando. No painel da Pagar.me, verifique se o webhook existe para a conta e o modo que você usa, se a URL dele é exatamente a exibida em Webhook URL e se os eventos listados acima estão selecionados. O pedido também é verificado sempre que o cliente retorna à loja.
The webhook answers verification failed, retry later: a loja não conseguiu ler o pedido da Pagar.me pela API, por exemplo porque a chave desse modo está ausente ou a API não respondeu. A Pagar.me tenta o webhook novamente.
The webhook answers busy: o carrinho estava sendo processado por outra requisição no mesmo momento, ou o status do pedido não pôde ser definido. A Pagar.me tenta o webhook novamente. Ative Debug log para ver o motivo.
The webhook answers unknown order: o pedido da Pagar.me não foi criado por esta loja, por exemplo um pedido de outra loja na mesma conta. Nada é alterado.
The webhook answers invalid payload or invalid order id: a requisição não é uma notificação da Pagar.me. Nada é alterado.
The customer sees Pagar.me payments are not available right now: a chave secreta está incorreta ou ausente. Verifique a chave do modo atual.
The customer sees Pagar.me could not start the payment: a Pagar.me recusou os dados de cobrança, por exemplo o CPF no campo personalizado. A mensagem indica o problema; o motivo completo está no log.
The customer sees A valid billing email is required for Pagar.me.: o e-mail do pedido não é válido.
The customer sees Pagar.me only supports payments in Brazilian Real (BRL).: a finalização da compra está em outra moeda.
The customer sees This order already has a Pagar.me payment that the store has to review: um pagamento anterior do carrinho precisa da sua análise. Verifique o painel da Pagar.me e o log.
Order is in the review status after payment: leia as observações na aba VibeFox Pagar.me Gateway (veja Status de pedido) e depois atenda o pedido ou reembolse o pagamento.
No refund form in the tab: a aba informa o motivo: o pagamento ainda não foi informado, está totalmente reembolsado, seu grupo de usuários não tem o direito de modificar a extensão ou a chave secreta do modo do pagamento não está definida.
Refund fails for a boleto: pagamentos por boleto não podem ser reembolsados pela API. Reembolse no painel da Pagar.me e registre o reembolso manualmente.
Para desenvolvedores: antes do envio do pedido à Pagar.me, a extensão dispara o evento do OpenCart wc_pgm_order_data com o corpo da requisição e o pedido. O valor do pagamento deve permanecer igual ao total do pedido.
Desinstalação
Acesse Extensions > Extensions, escolha o tipo Payments e clique em Uninstall (o botão vermelho −) ao lado de VibeFox Pagar.me Gateway. A chave de licença e o status da licença desta extensão são sempre removidos. O OpenCart sempre remove as próprias configurações da extensão: Enable / Disable, Sort Order, Geo Zone, Total e os status de pedido da seção Orders, que voltam aos padrões em uma reinstalação. O evento do OpenCart da extensão também é removido (no OpenCart 4, seus eventos e sua ação de inicialização, que deixa passar o webhook e o retorno do cliente no modo de manutenção). Se Delete data on uninstall estiver ativado, as demais configurações do gateway (título, descrição, modo de teste, chaves secretas, métodos de pagamento, dias do boleto, registro de log) e o log são removidos. Se estiver desativado, elas são mantidas para uma reinstalação posterior. Os registros de pagamento e reembolso da Pagar.me são sempre mantidos, de modo que pedidos pagos antes ainda podem ser reembolsados após uma reinstalação. Os pedidos existentes mantêm suas observações de pagamento.
No OpenCart 4, para remover também os arquivos da extensão, acesse Extensions > Installer após a desinstalação e clique em Uninstall (o botão laranja −) ao lado de VibeFox Pagar.me Gateway na lista de extensões instaladas, depois em Delete (o botão vermelho com a lixeira) para remover o pacote enviado.
Pagar.me é uma marca registrada de seu respectivo proprietário. Esta extensão não é afiliada nem endossada pela Pagar.me.