Voltar

VibeFox PayU 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 superior, com a extensão cURL.

Moeda: a moeda de finalização de compra do cliente deve ser uma das seguintes: PLN, EUR, CZK, HUF, RON, BGN, GBP, USD, CHF, DKK, NOK, SEK, UAH. A moeda também precisa estar habilitada para o seu ponto de venda na PayU. Para outras moedas, o método de pagamento fica oculto na finalização de compra.

Acesso à internet para a sua loja: a PayU envia as notificações de pagamento para a sua loja, por isso ela precisa estar acessível pela internet (não pode estar protegida por autenticação HTTP nem bloqueada por firewall). Sem as notificações, os pagamentos continuam sendo verificados quando o cliente retorna da PayU.

Conta na PayU: você precisa de quatro chaves do seu ponto de venda (POS): POS ID, Second key (MD5), OAuth client_id e OAuth client_secret. Elas estão no painel do comerciante da PayU, em Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys. As chaves de sandbox vêm de uma conta de sandbox da PayU separada.

Chave de licença VibeFox: adquirida em vibefox.net. Uma chave funciona em um 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_payu_payment-oc3-(version).ocmod.zip e o pacote do OpenCart 4 wcp_payu_payment.ocmod.zip. Instale apenas o pacote da sua versão do OpenCart. A chave de licença é a mesma para as duas versões.

OpenCart 3

1. No admin, acesse Extensions > Installer, clique em Upload e escolha o arquivo wcp_payu_payment-oc3-(version).ocmod.zip. A extensão não tem modificações OCMOD, por isso 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. Encontre VibeFox PayU Payment e clique em Install (o botão verde +). O seu usuário administrador precisa ter permissão para 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 a 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. Preencha as quatro chaves de Sandbox e as quatro chaves de Live (veja Configuração). Não é preciso configurar nenhuma URL de notificação na PayU.

5. Ative Enable/Disable e clique em Save. Deixe Test Mode ativado até fazer um pagamento de teste e, depois, desative-o para aceitar pagamentos reais com as chaves Live.

OpenCart 4

1. No admin, acesse Extensions > Installer, clique em Upload e escolha o arquivo wcp_payu_payment.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. Encontre VibeFox PayU Payment, 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 e as chaves da PayU como nos passos 3 a 5 do OpenCart 3. A página de configurações e os campos são os mesmos nas duas versões. Só a URL de notificação é diferente (veja Notificações de pagamento).

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 PayU Payment > 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 avisa quando o modo sandbox está ativo (O modo Sandbox (teste) está ativo: os pagamentos vão para o sandbox da PayU e nenhum valor real é cobrado. Não envie pedidos pagos em modo de teste.), quando uma das quatro chaves do modo atual está faltando (nesse caso a PayU não aparece na finalização de compra) e quando a PayU não aceita a moeda padrão da loja (nesse caso a PayU fica oculta para pedidos nessa moeda). Sem a permissão para modificar a extensão, a página mostra as configurações, mas não consegue salvá-las.

Ao salvar, espaços e quebras de linha são removidos de todas as chaves, porque copiar do painel da PayU costuma trazer esses caracteres. Title não pode ficar vazio nem ter mais de 128 caracteres (a página mostra Informe um título para o método de pagamento (no máximo 128 caracteres).), Sort Order precisa ser um número inteiro (números negativos são permitidos), Total precisa ser um número igual ou maior que 0, e a zona geográfica e os status de pedido precisam existir. Caso contrário, nada é salvo. Salvar as configurações também limpa os tokens de acesso da PayU armazenados em cache.

PayU

Enable/Disable: Enable PayU payment gateway ativa ou desativa o método de pagamento. Padrão: desativado.

Title: o nome do método de pagamento que o cliente vê na finalização de compra. Ele também é o nome do método de pagamento salvo no pedido. Padrão: PayU. Obrigatório, no máximo 128 caracteres.

Description: o texto exibido ao cliente na etapa Confirm Order, acima do botão de confirmação. Padrão: Pay securely via PayU.

Sort Order: a posição da PayU entre os métodos de pagamento na finalização de compra. Deixe em branco ou informe um número inteiro.

Geo Zone: oferecer a PayU somente para endereços de pagamento na zona geográfica selecionada. Padrão: All zones. As zonas geográficas são configuradas em System > Localisation > Geo Zones.

Total: o total da finalização de compra, na moeda padrão da loja, que um pedido precisa atingir para que a PayU seja oferecida. Deixe em branco para oferecer a PayU em qualquer valor.

Credenciais de API

Encontre as chaves no painel do comerciante da PayU: Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys. As chaves de sandbox vêm de uma conta de sandbox da PayU separada. Todas as quatro chaves de um modo precisam estar preenchidas. A seção contém links para a documentação para desenvolvedores da PayU.

Test Mode: usa o sandbox da PayU e as chaves Sandbox abaixo. Nenhum valor real é cobrado. Enquanto estiver ativo, os clientes veem Modo sandbox: nenhum pagamento real é efetuado. na etapa Confirm Order. Desative-o para aceitar pagamentos reais com as chaves Live. Padrão: ativado.

Live POS ID: o POS ID (merchantPosId) do seu ponto de venda de produção.

Live Second Key (MD5): usada para verificar a assinatura das notificações da PayU.

Live OAuth Client ID: o client_id OAuth do ponto de venda.

Live OAuth Client Secret: o client_secret OAuth do ponto de venda.

Sandbox POS ID: o POS ID do seu ponto de venda de sandbox da PayU.

Sandbox Second Key (MD5): usada para verificar a assinatura das notificações do sandbox da PayU.

Sandbox OAuth Client ID: o client_id OAuth do ponto de venda de sandbox.

Sandbox OAuth Client Secret: o client_secret OAuth do ponto de venda de sandbox.

As Second Keys e os client secrets salvos nunca são exibidos novamente. O campo fica vazio e mostra Salvo — deixe em branco para mantê-lo. Informe um novo valor somente se quiser alterá-lo. Os POS IDs e os client IDs são exibidos como foram salvos.

Clear saved secrets: marque um segredo e clique em Save para removê-lo. Um campo vazio mantém o valor salvo.

Cada pagamento guarda o seu ambiente. Notificações, consultas de status, recebimento ou cancelamento de um pagamento e reembolsos sempre usam as chaves desse ambiente; assim, os pagamentos antigos continuam funcionando depois que você troca de modo. Uma notificação assinada com a chave de sandbox nunca é aceita para um pagamento real, e vice-versa.

Status do pedido

O OpenCart cria o pedido na etapa Confirm Order sem status (um pedido ausente). O pedido só recebe um status depois que a PayU confirma o pagamento, por uma notificação assinada ou pela consulta de status quando o cliente retorna. O OpenCart não tem o status On hold: os status de espera ficam, por padrão, como Pending, e a aba PayU do pedido e as suas notas explicam o motivo. Cada campo abaixo lista os seus status de pedido do OpenCart; você pode criar os seus próprios em System > Localisation > Order Statuses.

Order Status After Payment: definido quando a PayU confirma o pagamento (COMPLETED) e o valor e a moeda conferem. Padrão: Processing.

Awaiting PayU Payment Confirmation: o pagamento foi autorizado e aguarda o recebimento (recebimento automático desativado ou com falha). Use Receive PayU payment ou Cancel PayU payment na aba PayU do pedido. Padrão: Pending.

PayU Payment On Hold: o valor pago ou a moeda não correspondem ao pedido, ou um pagamento foi concluído para um pedido cancelado. O pedido não é marcado como pago; a nota explica o motivo. Padrão: Pending.

Payment Error Status: o pagamento de um pedido que aguardava confirmação foi cancelado ou recusado. Padrão: Failed.

Cancelled Order Status: um pagamento da PayU concluído para um pedido nesse status faz o pedido ir para espera, em vez de reabri-lo silenciosamente. A extensão nunca define esse status. Padrão: Canceled.

Refunded Status: definido após o reembolso total do pagamento pela aba PayU do pedido. Padrão: Refunded.

Notificações de pagamento

Notification URL: mostra o endereço para o qual a PayU envia as notificações. No OpenCart 3 ele tem a forma https://your-store/index.php?route=extension/payment/wcp_payu_payment/notify; no OpenCart 4, https://your-store/index.php?route=extension/wcp_payu_payment/payment/wcp_payu_payment.notify. Ele é montado a partir do endereço da vitrine da sua instalação do OpenCart. A extensão a envia para a PayU em cada pagamento, portanto nada precisa ser configurado no painel da PayU. Garanta que ela esteja acessível pela internet (sem bloqueio de firewall ou autenticação HTTP). As notificações também funcionam quando a loja está em modo de manutenção (no OpenCart 4, pela ação de inicialização da extensão, que também deixa passar o retorno do cliente da PayU). Notificações sem assinatura válida são rejeitadas.

Avançado

Receive payments automatically: recebe automaticamente os pagamentos que aguardam confirmação. Isso só importa se o recebimento automático estiver desativado para o seu ponto de venda no painel da PayU: nesse caso, os pagamentos ficam aguardando confirmação (WAITING_FOR_CONFIRMATION). Com esta opção ativada, a extensão recebe esses pagamentos imediatamente e o pedido recebe o status de pago quando a PayU informa que o pagamento foi concluído. Quando ela está desativada, ou se o recebimento falhar, o pedido recebe Awaiting PayU Payment Confirmation, e você recebe ou cancela o pagamento com os botões da aba PayU do pedido. Padrão: ativado.

Logging: registra eventos técnicos (números de pedido, IDs de pedido da PayU, status, erros; sem chaves nem dados pessoais) no arquivo wc_pu_debug.log.php, na pasta de logs do OpenCart (storage/logs). O arquivo não pode ser aberto pela web. Erros são sempre registrados; os demais eventos só enquanto esta opção estiver ativada. Padrão: desativado.

Log: mostra o tamanho e as últimas entradas 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. Pedidos e os seus dados de pagamento (transações e reembolsos da PayU) nunca são excluídos. Os tokens de acesso da PayU em cache são sempre removidos. Padrão: desativado.

Importar / Exportar

Export: Download JSON salva as configurações em um arquivo JSON. Os segredos não são exportados.

Import: cole o JSON exportado anteriormente e clique em Import para restaurar as configurações. Os segredos salvos são mantidos.

Finalização de compra

Na etapa Payment Method, o cliente escolhe o método de pagamento (por padrão, PayU). Na etapa Confirm Order, o cliente vê a sua descrição e a nota Você será redirecionado para a PayU para concluir o pagamento (BLIK, transferência bancária, cartão e outros métodos). O OpenCart cria o pedido nessa etapa, ainda sem status. No OpenCart 4 o cliente escolhe o método de pagamento com o botão Choose do bloco de métodos de pagamento, na janela Payment method options, e clica em Confirm Order no final da página de finalização de compra. Quando o cliente clica em Confirm Order, a extensão cria um pedido na PayU pelo total do pedido na moeda do pedido, com a descrição Order #, o número do pedido e o nome da sua loja, e com os produtos, o método de envio e as demais linhas de total do pedido para exibição na página da PayU. O e-mail, o nome e o telefone do cliente são enviados à PayU, e o idioma da página da PayU acompanha o idioma da vitrine. O cliente é levado à página da PayU, escolhe um método e paga.

Cada tentativa recebe o seu próprio pedido na PayU. Quando o cliente tenta de novo (no OpenCart 3, um novo pedido é criado sempre que a etapa Confirm Order é exibida; no OpenCart 4, o pedido do checkout é atualizado), os pagamentos não concluídos da PayU de tentativas anteriores do mesmo pedido e do mesmo carrinho são cancelados na PayU, para que um link de pagamento antigo não possa ser pago duas vezes. Se um pagamento anterior se revelar já pago, ele é aproveitado no lugar, e um pedido ou carrinho já pago, em espera ou aguardando confirmação vai direto para a página de sucesso, sem um segundo pagamento. Uma alteração do carrinho, inclusive uma nova quantidade, conta como um novo carrinho que precisa de um pagamento próprio.

O retorno do cliente à sua loja, sozinho, nunca quita um pedido. O pedido só é marcado como pago depois que a PayU o confirma: por uma notificação assinada com a Second Key do ambiente do pagamento, ou por uma consulta de status do pedido na PayU feita no servidor quando o cliente volta (no máximo uma vez a cada 10 segundos por pagamento). O valor e a moeda precisam conferir. O pedido então recebe o seu status da forma padrão do OpenCart, com os e-mails habituais do pedido e a atualização do estoque. A extensão trata estes status da PayU:

COMPLETED: o pagamento foi feito. O pedido é marcado como pago quando o valor e a moeda conferem.
WAITING_FOR_CONFIRMATION: o pagamento foi autorizado e aguarda o recebimento; veja Receive payments automatically.
CANCELED: o pagamento foi cancelado ou recusado. Só a última tentativa conta. Um pedido sem status continua sem status, e o cliente pode pagar novamente.
NEW, PENDING: o pagamento está em andamento na PayU. Nada muda.

Após um pagamento confirmado, o cliente vê a página de sucesso do pedido do OpenCart. Para um pedido aguardando confirmação ou em espera, a página acrescenta Seu pagamento está sendo verificado. Enviaremos um e-mail assim que ele for confirmado. Quando esse pedido é pago depois ou o pagamento dele falha, o OpenCart informa o cliente sobre o novo status. Se o pagamento do pedido falhou, a página mostra Seu pagamento na PayU não foi concluído. Entre em contato conosco sobre este pedido.

Se a PayU ainda não tiver confirmado o pagamento quando o cliente voltar, uma página de Payment confirmation mostra Ainda não recebemos a confirmação do pagamento da PayU. Se o pagamento foi interrompido, você pode tentar novamente: (ou, quando a PayU informou um erro, O pagamento não foi concluído. Você pode tentar novamente:) com os botões Pay again (voltar à finalização de compra) e Check again. A notificação define o status do pedido assim que chega. Se o pagamento foi cancelado, o cliente volta à finalização de compra com O pagamento não foi concluído. Você pode tentar novamente ou escolher outro método de pagamento. O carrinho é mantido. No OpenCart 4 essa mensagem é exibida acima da página de finalização de compra.

No OpenCart 4, o pedido permanece na finalização de compra até que a página de sucesso seja exibida. Se esse pedido tiver sido fechado nesse meio-tempo (por exemplo, se o pagamento pendente dele foi cancelado, ou se você o cancelou ou reembolsou), o cliente volta à finalização de compra com a mensagem Seu pedido anterior foi fechado (não pago, cancelado ou reembolsado). Confirme o pedido novamente para pagar com um novo pedido. Quando o cliente volta da PayU para um pedido fechado sem pagamento, a mensagem é O pagamento não foi concluído. Você pode tentar novamente ou escolher outro método de pagamento. Se esse pedido já tiver sido pago por um carrinho anterior e o carrinho tiver mudado desde então, o cliente volta à finalização de compra. Em todos os casos, o próximo Confirm Order paga um novo pedido do carrinho atual. Um pedido fechado nunca é mostrado como pago.

Se a PayU não conseguir iniciar o pagamento, o cliente permanece na etapa Confirm Order com Erro de pagamento. Tente novamente ou escolha outro método de pagamento. O motivo técnico é gravado no log. Se as chaves do modo atual estiverem faltando, a mensagem é O gateway de pagamento não está configurado corretamente. Entre em contato com o administrador.

O cliente escolhe o método de pagamento na página da PayU, e não na sua finalização de compra. A extensão não tem formulário de cartão no seu site, nem cartões salvos ou pagamentos com um clique, nem assinaturas, nem widgets de parcelamento ou crédito da PayU. Ela usa um ponto de venda por ambiente.

Pedidos e reembolsos

Status do pedido

Sem status (pedido ausente): o cliente foi enviado à PayU e não pagou, o pagamento foi cancelado ou a PayU ainda não confirmou o pagamento. Em Sales > Orders, esses pedidos só aparecem com o filtro Order Status definido como Missing Orders.

Order Status After Payment (padrão Processing): o pagamento foi confirmado. Uma nota mostra o ID do pedido na PayU, o valor e o ambiente (sandbox ou live).

Awaiting PayU Payment Confirmation (padrão Pending): o pagamento foi autorizado e aguarda você (recebimento automático desativado ou recebimento com falha).

PayU Payment On Hold (padrão Pending): o valor pago ou a moeda não correspondia ao pedido, um pagamento aguardando confirmação tinha outro valor, ou um pagamento foi concluído para um pedido que havia sido cancelado. A nota informa qual caso ocorreu. Confira o pedido e atenda-o ou reembolse o pagamento.

Payment Error Status (padrão Failed): o pagamento de um pedido que aguardava confirmação foi cancelado ou recusado.

Refunded Status (padrão Refunded): o pagamento foi totalmente reembolsado pela extensão.

Cada notificação é processada uma única vez: notificações repetidas não acrescentam notas nem alteram o pedido novamente. Se outro pagamento for concluído para um pedido já pago ou reembolsado, ou para outro pedido de um carrinho já pago, uma nota no pedido pago pede que você reembolse o valor no painel da PayU. Um pagamento aguardando confirmação em um pedido já pago ou encerrado é cancelado automaticamente, para que o dinheiro não seja cobrado duas vezes.

As notas são entradas do History do pedido, que o cliente não vê.

Aba VibeFox PayU Payment

Em Sales > Orders, abra um pedido pago com a PayU. Na parte inferior da página do pedido, ao lado de History e Additional, a aba VibeFox PayU Payment mostra o PayU order ID, com a etiqueta Sandbox nos pagamentos de sandbox, o extOrderId, o PayU status, o Payment amount, os valores Paid / refunded, o formulário de reembolso, o histórico de Refunds, as PayU payment attempts do pedido e as PayU notes. A aba é exibida para os usuários que têm acesso à extensão; as ações dela exigem a permissão para modificar a extensão (definida em System > Users > User Groups).

Pagamentos aguardando confirmação

Para um pedido com pagamento aguardando confirmação, a aba mostra Receive PayU payment e Cancel PayU payment. Depois que você confirma a pergunta, a ação é enviada à PayU com as chaves do ambiente do pagamento, acrescentada às notas com o seu nome de usuário, e o novo status da PayU é aplicado na hora: um pagamento recebido define Order Status After Payment, e um cancelado define Payment Error Status.

Reembolsos

Na aba, informe o Amount (o valor ainda não reembolsado já vem preenchido), opcionalmente um Reason (optional), e clique em Refund via PayU. Confirme a pergunta Refund this amount through PayU? This cannot be undone. Reembolsos totais e parciais são suportados. Os reembolsos ficam disponíveis assim que a PayU conclui o pagamento. O reembolso é enviado para o pedido da PayU que foi efetivamente pago, com as chaves do ambiente do pagamento, por isso essas chaves precisam estar configuradas. Os reembolsos são feitos no valor e na moeda que a PayU cobrou; assim, depois de uma divergência de valor ou moeda, você pode reembolsar até o que o cliente realmente pagou, e não o total do pedido. O motivo é enviado como descrição do reembolso. Se a PayU recusar o reembolso, a aba mostra o erro da PayU e nenhum reembolso é registrado. Um reembolso total define o pedido como Refunded Status, sem notificar o cliente e sem devolver os produtos ao estoque. Um reembolso parcial não altera o status.

Os reembolsos são assíncronos na PayU. A extensão adiciona imediatamente uma nota com o ID e o status do reembolso na PayU; o status final chega depois por uma notificação da PayU e é acrescentado às notas e ao histórico de reembolsos. Se a PayU cancelar um reembolso, a nota informa que o dinheiro não voltou ao cliente, e o valor pode ser reembolsado novamente.

Devoluções de produtos em Sales > Returns não devolvem dinheiro pela PayU.

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 PayU Payment é o primeiro bloco em Extensions > Extensions > Payments > VibeFox PayU Payment > 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 consultar 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-payu e o link Manage licenses and domains in your account, que abre a sua conta no vibefox.net. Apenas usuários administradores com a permissão Modify para a extensão podem alterar a chave. Os textos do bloco seguem o idioma do admin (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 que o endereço da loja mudar, ou depois que você 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 na configuração do OpenCart. Remover a chave da loja não libera a vaga de domínio. Libere a vaga na sua conta no vibefox.net.

Sem uma chave ativa, a PayU não é exibida aos clientes na finalização de 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 ao admin 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 do admin, 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 do admin. Feche-o com × para ocultá-lo por 7 dias. Os pedidos existentes não são afetados: pagamentos já iniciados continuam sendo confirmados pelas notificações, 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 quando você abre o Dashboard ou a página Edit do admin: uma vez por dia nos primeiros 14 dias após a chave ser informada e, depois, uma vez por semana. Não é necessário cron job. Desinstalar a extensão sempre remove a chave de licença e o status da licença.

Solução de problemas

A PayU não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ativado e se as quatro chaves do modo atual estão preenchidas: as chaves Sandbox no modo sandbox, as chaves Live no modo live. Verifique se a moeda do cliente é uma das moedas suportadas, se o endereço de pagamento está na Geo Zone selecionada e se o pedido atinge o Total definido nas configurações. A página de configurações exibe um aviso quando há chaves faltando ou quando a moeda da loja não é suportada.

O pagamento foi feito, mas o pedido continua sem status: a PayU ainda não entregou a notificação, e a consulta de status na página de retorno não encontrou um pagamento concluído. Verifique se a URL de notificação exibida nas configurações está acessível pela internet. Ative o Logging para ver o que chega. O cliente também pode clicar em Check again na página Payment confirmation.

A notificação responde Invalid signature: a notificação não foi assinada com a Second Key de nenhum dos dois ambientes. Verifique Live Second Key (MD5) e Sandbox Second Key (MD5). A resposta Invalid signature for this payment significa que a notificação foi assinada com a chave do outro ambiente, diferente do ambiente do pagamento.

A notificação responde Ignored: unknown PayU order: o pedido da PayU não foi criado por esta loja, por exemplo outra loja no mesmo ponto de venda. A PayU deixa de tentar novamente.

A notificação responde Busy, retry later: o carrinho estava sendo confirmado por outra requisição no mesmo momento. A PayU repete a notificação. Ative o Logging para ver o motivo.

A URL de notificação mostra POST expected no navegador: isso é normal. A URL aceita somente notificações da PayU.

O cliente vê Payment error após Confirm Order: ative o Logging e verifique o campo Log na página da extensão. O log mostra o código HTTP e o status da PayU. Could not authenticate with PayU (check the OAuth client ID / secret). significa chaves OAuth erradas do modo atual. This payment method is not available. significa que a sessão da finalização de compra não corresponde mais ao pedido ou que o método de pagamento foi desativado nesse meio-tempo: o cliente precisa recarregar a finalização de compra.

O pedido está em PayU Payment On Hold: leia as notas na aba VibeFox PayU Payment (veja Status do pedido) e, em seguida, atenda o pedido ou reembolse o pagamento.

O pedido está em Awaiting PayU Payment Confirmation: o recebimento automático está desativado para o seu ponto de venda e o pagamento aguarda você. Use Receive PayU payment ou Cancel PayU payment na aba.

O reembolso falha ou não há formulário de reembolso: a aba informa o motivo. Refunds are available once PayU has completed the payment. significa que a PayU ainda não concluiu um pagamento para o pedido. A mensagem de que faltam as chaves Sandbox ou Live significa que o pagamento foi feito nesse ambiente e que as chaves dele não estão preenchidas. Informe-as e tente novamente. Sem a permissão para modificar a extensão, a aba mostra You do not have permission to refund (modify this extension).

Desinstalação

Acesse Extensions > Extensions, escolha o tipo Payments e clique em Uninstall (o botão vermelho −) ao lado de VibeFox PayU Payment. 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 Order statuses, que voltam aos padrões em uma reinstalação. O evento do OpenCart da extensão e os tokens de acesso da PayU em cache também são removidos (no OpenCart 4, também os seus eventos e a sua ação de inicialização, que deixa passar as notificações 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, recebimento automático, logging) e o log são removidos. Se estiver desativado, elas são mantidas para uma reinstalação futura. As transações e os reembolsos da PayU são sempre mantidos, de modo que pedidos pagos antes podem ser reembolsados após uma reinstalação. Os pedidos existentes mantêm as suas notas de pagamento.

No OpenCart 4, para remover também os arquivos da extensão, depois da desinstalação acesse Extensions > Installer, clique em Uninstall (o botão laranja −) ao lado de VibeFox PayU Payment na lista de extensões instaladas e depois em Delete (o botão vermelho com a lixeira) para remover o pacote enviado.

A PayU é uma marca registrada de seu respectivo titular. Esta extensão não é afiliada nem endossada pela PayU.