VibeFox Przelewy24 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.

Moeda: o pedido deve estar em PLN, EUR, GBP ou CZK. Em outras moedas, o método de pagamento fica oculto na finalização de compra. O pedido é cobrado na própria moeda; a extensão não converte moedas.

Conta na Przelewy24: você precisa de uma conta de comerciante na Przelewy24 e dos seus dados de API: o Merchant ID, a chave de API (chamada report key no painel da Przelewy24), a CRC key e, se a sua loja tiver um ID próprio, o POS ID (Shop ID). Você os encontra no painel de comerciante da Przelewy24, em panel.przelewy24.pl, em My data > API data and configuration. As chaves de sandbox vêm de uma conta de sandbox separada, em sandbox.przelewy24.pl/panel. Nada mais precisa ser configurado no painel da Przelewy24: a extensão envia a URL de notificação em cada pagamento. A sua loja precisa estar acessível pela internet, porque a Przelewy24 envia para ela as notificações de pagamento.

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 README.txt, o pacote do OpenCart 3 wcp_przelewy24_payment-oc3-(version).ocmod.zip e o pacote do OpenCart 4 wcp_przelewy24_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 painel de administração, acesse Extensions > Installer, clique em Upload e escolha o arquivo wcp_przelewy24_payment-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 Przelewy24 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 ícone de 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. Informe as chaves de sandbox (Merchant ID, chave de API, CRC key; o POS ID somente se for diferente do Merchant ID), ative Enable/Disable, clique em Save e faça um pagamento de teste no modo sandbox.

5. Informe as chaves de produção, desative Test Mode e clique em Save para aceitar pagamentos reais.

OpenCart 4

1. No painel de administração, vá em Extensions > Installer, clique em Upload e escolha o arquivo wcp_przelewy24_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. Vá em Extensions > Extensions e escolha o tipo Payments. Encontre VibeFox Przelewy24 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 Przelewy24 como nos passos 3 a 5 do OpenCart 3. A página de configurações e os seus campos são iguais nas duas versões. Só a URL de notificação é diferente (veja Notificações de pagamento).

Uma nova instalação 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 Przelewy24 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 mostra avisos quando algo está faltando. Enquanto o sandbox estiver ativo: Sandbox (test) mode is on: payments go to the Przelewy24 sandbox and no real money is charged. Do not ship orders paid in test mode. Quando as chaves do modo atual estão incompletas: Enter the Sandbox Merchant ID, API key and CRC key - until then Przelewy24 is not shown at checkout. (ou o mesmo para as chaves de produção). Quando a Przelewy24 não aceita a moeda padrão da sua loja, o aviso informa a moeda e as moedas aceitas. Depois de salvar, os avisos acompanham imediatamente o novo modo e as novas chaves. Sem a permissão para modificar a extensão, a página mostra as configurações, mas não consegue salvá-las.

Ao salvar, nada é salvo se algum campo estiver incorreto: Title não pode ficar vazio (Enter a title for the payment method (at most 128 characters).), Sort Order precisa ser um número inteiro (valores negativos são permitidos), Total precisa ser um número igual ou maior que 0, e a Geo Zone e os status de pedido precisam existir. Chaves em branco não impedem o salvamento. Espaços e quebras de linha copiados junto com as chaves do painel da Przelewy24 são removidos ao salvar.

Przelewy24

Enable/Disable: Enable Przelewy24 Payment liga ou desliga o método de pagamento. Padrão: off.

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

Description: o texto mostrado ao cliente na etapa Confirm Order, acima do botão de confirmação. Padrão: Pay with BLIK, online bank transfer or card via Przelewy24.

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

Geo Zone: oferecer a Przelewy24 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 valor total do carrinho, na moeda padrão da loja, que um pedido precisa atingir para que a Przelewy24 seja oferecida. Deixe em branco para oferecer a Przelewy24 em qualquer valor.

Credenciais de API

Esta seção explica onde encontrar as chaves (My data > API data and configuration no painel de comerciante da Przelewy24) e traz links para o painel da Przelewy24 e para o painel de sandbox.

Test Mode: usa o sandbox da Przelewy24 e as chaves Sandbox. Nenhum dinheiro real é cobrado. Desative para aceitar pagamentos reais com as chaves de produção. Padrão: on. Enquanto estiver ativo, os clientes veem Sandbox mode - no real money is charged na etapa Confirm Order.

Chaves de produção

Live Merchant ID: o seu ID de comerciante na Przelewy24, somente números.

Live POS ID (optional): o Shop ID (posId). Deixe em branco se for igual ao Merchant ID.

Live API key (report key): a chave de API do painel da Przelewy24. Ela é usada para autenticação na API.

Live CRC key: usada para assinar as requisições enviadas à Przelewy24 e para verificar a assinatura das notificações da Przelewy24.

Chaves de sandbox

Sandbox Merchant ID: o Merchant ID da sua conta de sandbox na Przelewy24.

Sandbox POS ID (optional): o Shop ID (posId) da conta de sandbox. Deixe em branco se for igual ao Merchant ID.

Sandbox API key (report key): a chave de API da conta de sandbox.

Sandbox CRC key: a CRC key da conta de sandbox, usada para assinar as requisições e verificar as notificações de sandbox.

As chaves de API e as CRC keys salvas nunca são exibidas novamente. O campo fica vazio e mostra Saved - leave empty to keep it. Digite um novo valor somente se quiser alterá-lo. Para remover uma chave salva, marque Clear the saved value abaixo do campo e clique em Save.

As chaves de produção e as de sandbox são diferentes. O Merchant ID e o POS ID devem conter somente dígitos; enquanto o Merchant ID, a chave de API e a CRC key do modo atual não forem informados, o método de pagamento não aparece na finalização de compra. Um pagamento iniciado em um modo é sempre verificado e reembolsado com as chaves desse modo, mesmo depois de você trocar de modo; por isso, mantenha as chaves do modo antigo enquanto os pagamentos dele estiverem abertos ou puderem ser reembolsados.

Notificações de pagamento

Notification URL: o endereço que recebe as notificações de pagamento da Przelewy24. No OpenCart 3 ele tem a forma https://your-store/index.php?route=extension/payment/wcp_przelewy24_payment/notify, e no OpenCart 4, https://your-store/index.php?route=extension/wcp_przelewy24_payment/payment/wcp_przelewy_24payment.notify. Ele é gerado a partir do endereço da vitrine da sua instalação do OpenCart. A extensão envia essa URL à Przelewy24 em cada pagamento e em cada reembolso, então nada precisa ser configurado no painel da Przelewy24. A URL precisa estar acessível pela internet: sem firewall nem autenticação HTTP na frente. Ela continua funcionando enquanto a loja está em modo de manutenção, porque o OpenCart 3 libera as requisições das extensões de pagamento, e no OpenCart 4 a extensão adiciona uma ação de inicialização para a URL de notificação e para o retorno do cliente. Sem as notificações, um pagamento ainda é confirmado quando o cliente volta para a loja (veja Finalização de compra); se o cliente não voltar, o pedido fica sem status.

Pedidos

O OpenCart cria o pedido na etapa Confirm Order sem status (um pedido ausente). O pedido recebe um status somente depois que a Przelewy24 confirma o pagamento e a extensão o verifica. Cada campo abaixo lista os seus status de pedido do OpenCart.

Paid Order Status: o status depois de um pagamento verificado. Padrão: Processing.

On Hold (Review) Status: pagamentos cujo valor ou moeda não correspondem ao pedido (não verificados), ou que chegam depois que o pedido foi cancelado, recebem este status e uma nota explicando o motivo. Padrão: Pending, porque o OpenCart não tem um status On hold. Você pode criar o seu próprio status em System > Localisation > Order Statuses e selecioná-lo aqui.

Cancelled Order Status: a extensão nunca o define. Um pagamento verificado para um pedido neste status coloca o pedido em espera, em vez de reabri-lo silenciosamente. Padrão: Canceled.

Refunded Status: definido depois que o pagamento é totalmente reembolsado pela página do pedido. Padrão: Refunded.

Avançado

Debug Log: grava eventos técnicos (números de pedido, IDs de transação da P24, erros) no arquivo wc_p24_debug.log.php, na pasta de logs do OpenCart (storage/logs). O arquivo não pode ser aberto pela web e, ao atingir 5 MB, é movido para wc_p24_debug.old.log.php. Erros e avisos, como notificações rejeitadas ou uma verificação ou reembolso com falha, são sempre registrados; ative a chave para registrar também cada etapa. Chaves e dados pessoais nunca são registrados. Padrão: off.

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. Pedidos e os seus dados de pagamento da Przelewy24 nunca são excluídos. Padrão: off.

Importar / Exportar

Export: Download JSON salva as configurações em um arquivo JSON. As chaves de API e as CRC keys não são exportadas.

Import: cole um JSON exportado anteriormente e clique em Import para restaurar as configurações. As chaves de API e as CRC keys salvas são mantidas.

Finalização de compra

Na etapa Payment Method, o cliente escolhe o método de pagamento (por padrão, Przelewy24). Na etapa Confirm Order, o cliente vê a sua descrição e a nota You will be redirected to the secure Przelewy24 page to complete the payment. O OpenCart cria o pedido nesta etapa, ainda sem status. Quando o cliente clica em Confirm Order, a extensão registra uma transação na Przelewy24 pelo total do pedido na moeda do pedido, com o e-mail, o nome e o país de cobrança do cliente, e com a descrição Order # seguida do número do pedido e do nome da sua loja. Cada tentativa de pagamento recebe o seu próprio ID de sessão. O cliente é enviado para a página de pagamento da Przelewy24 e paga com BLIK, transferência bancária online, cartão ou outro método ativado para a sua conta na Przelewy24. A página de pagamento é exibida no idioma do pedido, se a Przelewy24 oferecer suporte a ele; caso contrário, em inglês. No OpenCart 4, o cliente escolhe o método de pagamento com o 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 de compra.

O pedido só é marcado como pago depois que a Przelewy24 confirma o pagamento. A Przelewy24 envia uma notificação assinada para a sua loja. A extensão confere a assinatura com a CRC key, o Merchant ID e o POS ID; confere se a sessão foi registrada para este pedido e no mesmo modo; e confere se o valor e a moeda correspondem à tentativa de pagamento e ao total do pedido. Só então ela verifica a transação na Przelewy24 (a Przelewy24 credita apenas pagamentos verificados) e define o Paid Order Status da forma padrão do OpenCart, com os e-mails habituais do pedido e a atualização do estoque. Webhooks sem assinatura válida são rejeitados.

Depois de pagar, o cliente volta para a sua loja. Se a notificação ainda não tiver chegado, a extensão pede à Przelewy24 o status da transação com uma requisição autenticada de servidor para servidor (no máximo uma vez a cada 10 segundos por tentativa) e aplica as mesmas verificações. A página de retorno, sozinha, nunca marca um pedido como pago. Quando o pagamento é confirmado, o cliente vê a página de sucesso do pedido do OpenCart. Enquanto não for confirmado, uma página de Payment confirmation mostra We have not received the payment confirmation from Przelewy24 yet. If you have paid, it will be confirmed in a few minutes. If the payment was interrupted, you can try again: com um botão Check again e um botão Pay again que abre a finalização de compra. O carrinho é mantido, e um pagamento feito depois em uma página antiga da Przelewy24 continua sendo aceito. Se o pedido estiver em espera, a página de sucesso mostra Your payment is being verified. We will send you an e-mail as soon as it is confirmed. Quando um pagamento posterior move o pedido do status de espera para o Paid Order Status, o cliente é avisado por e-mail. Se você cancelou o pedido antes do pagamento e a Przelewy24 não tem nenhum pagamento para ele, o cliente que voltar verá Order #… was cancelled by the store before the payment was completed. No Przelewy24 payment was received for it. Please place a new order or contact us.

Se o pagamento não puder ser iniciado, o cliente permanece na etapa Confirm Order com uma breve mensagem acima do botão: Payment error: Przelewy24 could not start the payment. Please try again or choose another payment method. (o motivo vai para o log), Payment gateway is not configured properly. Please contact the administrator. (faltam as chaves do modo atual), uma mensagem informando que a Przelewy24 não pode aceitar pagamentos na moeda do pedido, ou The order total must be greater than zero. O OpenCart 3 cria um novo pedido sempre que a etapa Confirm Order é exibida; um pedido ou carrinho já pago não é reenviado à Przelewy24, e o cliente é levado à página de sucesso.

No OpenCart 4, o pedido do checkout é um só e é atualizado cada vez que a etapa Confirm Order é exibida; por isso, Pay again inicia uma nova transação na Przelewy24 para o mesmo pedido. Se esse pedido tiver sido fechado pela loja nesse meio-tempo (por exemplo, cancelado ou reembolsado), o cliente volta à finalização de compra com O seu pedido anterior foi fechado pela loja. Confirme o pedido novamente para criar e pagar um novo pedido. (para um pedido cancelado antes de qualquer pagamento, junto com a mensagem sobre o pedido cancelado acima), e o próximo clique em Confirm Order paga um novo pedido. Se o pedido da finalização já estiver pago, mas o carrinho tiver mudado desde então, inclusive com uma nova quantidade, o cliente vê Seu pedido anterior #… já foi realizado. O carrinho mudou: confirme o novo pedido para pagá-lo. e o novo carrinho é pago com um novo pedido. No OpenCart 4, essas mensagens, e We could not match this payment to an order. If you were charged, please contact us., são exibidas acima da página de finalização de compra.

A extensão não oferece cartões salvos ou pagamentos com um clique, assinaturas ou pagamentos recorrentes, escolha do método de pagamento da P24 (por exemplo, um campo para o código BLIK) na sua página de finalização de compra, widgets de parcelamento, e não envia o conteúdo do carrinho para a Przelewy24.

Pedidos e reembolsos

Status dos pedidos

Sem status (pedido ausente): o cliente foi enviado para a Przelewy24 e não pagou, ou o pagamento ainda não foi confirmado. Em Sales > Orders, esses pedidos aparecem somente com o filtro Order Status definido como Missing Orders.

Paid Order Status (padrão Processing): o pagamento foi verificado. Uma nota mostra o ID do pedido na P24, o valor e o modo. Cada pagamento é aplicado uma única vez.

On Hold (Review) Status (padrão Pending): o valor ou a moeda informados pela Przelewy24 diferem do pedido; o pagamento não foi confirmado e a nota informa isso. Ou o pagamento chegou e foi verificado para um pedido em status cancelado; o pedido não é reaberto silenciosamente, e a nota pede que você o envie ou reembolse o pagamento. Confira o pagamento no painel da Przelewy24. Se, depois de uma divergência, chegar mais tarde um pagamento correto de outra tentativa para um pedido em espera, o pedido passa para o Paid Order Status.

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

Se chegar um segundo pagamento para um pedido ou carrinho já pago ou reembolsado (um link de pagamento antigo, duas abas do navegador, outro pedido do mesmo carrinho), ele não é confirmado, por isso a Przelewy24 não o credita. Uma nota no pedido pago pede que você o verifique no painel da Przelewy24 e devolva o valor ao comprador, se necessário.

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

Aba VibeFox Przelewy24 Payment

Em Sales > Orders, abra um pedido pago com a Przelewy24. Na parte inferior da página do pedido, ao lado de History e Additional, a aba VibeFox Przelewy24 Payment mostra o ID do pedido na P24, a Session, o Environment (Sandbox ou Live), o Status do pagamento e como ele foi verificado (notificação ou retorno), os valores Paid / refunded, o formulário de reembolso, o histórico de reembolsos e as Payment notes do pedido. A aba é exibida para os usuários que têm acesso à extensão.

Reembolsos

Na aba VibeFox Przelewy24 Payment, informe o Amount (o valor ainda não reembolsado é preenchido), opcionalmente um Reason (optional), e clique em Refund via Przelewy24. Confirme a pergunta Refund this amount through Przelewy24? This cannot be undone. Reembolsos totais e parciais são aceitos, até o valor ainda não reembolsado. Você precisa da permissão para modificar a extensão (definida em System > Users > User Groups). O reembolso é enviado no modo em que o pagamento foi feito (sandbox ou produção), por isso as chaves desse modo precisam estar preenchidas. Os reembolsos ficam disponíveis depois que a Przelewy24 verifica o pagamento.

A Przelewy24 processa os reembolsos de forma assíncrona. A aba mostra Refund of … requested at Przelewy24. The result will be added as an order note., o histórico de reembolsos mostra o status requested e uma nota é adicionada. O resultado chega depois na URL de notificação: o status passa para completed com a nota Przelewy24: refund of … completed., ou para rejected com uma nota informando que o dinheiro não foi devolvido ao comprador. Um reembolso total define o pedido como Refunded Status no momento em que é solicitado, 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. Se um reembolso for rejeitado, verifique-o no painel da Przelewy24; o status do pedido não é revertido automaticamente.

Se a Przelewy24 não aceitar a solicitação de reembolso, a aba mostra Przelewy24 refund failed: com o motivo, e nenhum reembolso é registrado. Devoluções de produtos em Sales > Returns não devolvem dinheiro pela Przelewy24, e reembolsos feitos diretamente no painel da Przelewy24 não são adicionados ao pedido.

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 Przelewy24 Payment é o primeiro bloco de Extensions > Extensions > Payments > VibeFox Przelewy24 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 verificar o status novamente, Change key para informar outra chave e Remove key para remover a chave desta loja. Abaixo deles aparecem a linha Product: opencart-payment-przelewy24 e o link Manage licenses and domains in your account, que abre a sua conta em vibefox.net. Somente usuários administradores com a permissão Modify para a extensão podem alterar a chave. Os textos do bloco seguem o idioma do painel de administração (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 da configuração do OpenCart. Remover a chave da loja não libera a vaga de domínio. Libere a vaga na sua conta em vibefox.net.

Sem uma chave ativa, a Przelewy24 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 painel de administração 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 no painel de administração, então sem uma chave ativa o método de pagamento fica oculto para todos. Depois de abrir a página Edit uma vez, um lembrete aparece no Dashboard do painel de administração. Feche-o com × para ocultá-lo por 7 dias. Os pedidos existentes não são afetados: os pagamentos já iniciados continuam sendo verificados e confirmados, e os reembolsos funcionam.

Quando uma licença expira, a extensão continua funcionando, mas atualizações e suporte exigem a renovação. O status é verificado novamente de forma automática quando você abre o Dashboard ou a página Edit do painel de administração: uma vez por dia nos primeiros 14 dias após a chave ser informada e, depois, uma vez por semana. Nenhum cron job é necessário. Desinstalar a extensão sempre remove a chave de licença e o status da licença.

Solução de problemas

A Przelewy24 não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ligado, se o Merchant ID, a chave de API e a CRC key do modo atual estão informados (as chaves Sandbox enquanto Test Mode estiver ligado, as chaves Live caso contrário; Merchant ID e POS ID somente com dígitos) e se a moeda do pedido é PLN, EUR, GBP ou CZK. Os avisos no topo das configurações indicam o problema. Verifique também se o endereço de cobrança está na Geo Zone selecionada e se o pedido atinge o Total definido nas configurações.

O pagamento foi feito, mas o pedido continua sem status: a notificação da Przelewy24 não chegou à sua loja e o cliente não voltou à loja. Verifique se a Notification URL está acessível pela internet (sem firewall nem autenticação HTTP na frente) e se o Merchant ID, o POS ID e a CRC key do modo do pagamento estão corretos. As notificações rejeitadas são gravadas no log mesmo com o Debug Log desativado; consulte o campo Log na página da extensão.

Como a loja responde às notificações: uma notificação processada, repetida ou desconhecida recebe a resposta HTTP 200. Caso contrário, a Przelewy24 a envia novamente depois: 400 (dados ausentes ou malformados), 401 Invalid signature (CRC key incorreta, outro Merchant ID ou POS ID), 401 Invalid signature for this payment (notificação assinada com as chaves do outro modo, diferente do modo do pagamento), 405 (requisição que não é POST), 500 Verification failed (a verificação na Przelewy24 falhou; uma nota é adicionada ao pedido uma vez), 500 Order could not be updated (não foi possível definir o status do pedido; a notificação seguinte o define sem nova verificação) e 503 Busy, retry later (o pedido estava sendo confirmado por outra requisição no mesmo momento).

O cliente vê Payment error: Przelewy24 could not start the payment: a Przelewy24 rejeitou a transação, geralmente por chaves incorretas do modo atual (as chaves de sandbox funcionam apenas no modo sandbox, e as de produção apenas no modo de produção). O erro da Przelewy24 está no log.

O cliente vê We could not match this payment to an order: o link de retorno da Przelewy24 não correspondeu a nenhum pedido da loja. Se o cliente foi cobrado, localize o pagamento no painel da Przelewy24.

O pedido está em status de revisão após o pagamento: leia as notas na aba VibeFox Przelewy24 Payment. O valor ou a moeda eram diferentes do pedido, ou o pagamento chegou para um pedido que havia sido cancelado. Confira o pagamento no painel da Przelewy24 e depois processe o pedido ou reembolse o pagamento.

Um reembolso falha: This order has no verified Przelewy24 payment. Cannot process refund. significa que o pedido não foi pago por um pagamento verificado da Przelewy24. The payment was made in the Przelewy24 sandbox, but the Sandbox keys are missing. (ou o mesmo para produção) significa que as chaves do modo do pagamento foram removidas; informe-as novamente. Invalid refund amount significa que o valor está vazio, não é um número ou é maior que o valor ainda não reembolsado.

Para desenvolvedores: a lista de moedas pode ser alterada pelo evento do OpenCart wc_p24_supported_currencies (somente moedas com duas casas decimais).

Desinstalação

Acesse Extensions > Extensions, escolha o tipo Payments e clique em Uninstall (o botão vermelho −) ao lado de VibeFox Przelewy24 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 Orders, que voltam aos padrões em uma nova instalação. O evento do OpenCart da extensão também é removido (no OpenCart 4 também os seus eventos e a sua ação de inicialização, que deixam 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, chave do log de depuração) e o log são removidos. Se estiver desativado, elas são mantidas para uma reinstalação futura. Os dados de pagamento da Przelewy24 dos pedidos (sessões, IDs de pedido da P24, reembolsos) são sempre mantidos, para que pedidos pagos antes ainda possam 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, vá em Extensions > Installer depois da desinstalação e clique em Uninstall (o botão laranja −) ao lado de VibeFox Przelewy24 Payment na lista de extensões instaladas e, em seguida, em Delete (o botão vermelho com a lixeira) para remover o pacote enviado.

A Przelewy24 é uma marca registrada de seu respectivo proprietário. Esta extensão não é afiliada nem endossada pela Przelewy24.