Voltar

VibeFox Paytrail 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: EUR. A Paytrail aceita apenas euros. Para um pedido em qualquer outra moeda, o método de pagamento fica oculto na finalização de compra. Os valores são enviados em centavos.

Acesso à internet para a sua loja: a Paytrail confirma cada pagamento por uma callback de servidor para servidor, por isso a loja deve estar acessível pela internet. Sem as callbacks, os pedidos ainda são confirmados quando o cliente volta da Paytrail.

Conta Paytrail: você precisa do seu Merchant ID e da sua chave secreta, exibidos no Merchant Panel da Paytrail (dados da conta ou da integração). Para testes, nenhuma conta é necessária: o modo de teste usa a conta de teste pública da Paytrail. Os métodos de pagamento em si são habilitados na sua conta Paytrail.

Chave de licença VibeFox: 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_paytrail_gateway-oc3-(version).ocmod.zip e o pacote do OpenCart 4 wcp_paytrail_gateway.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 administrativo, vá em Extensions > Installer, clique em Upload e escolha o arquivo wcp_paytrail_gateway-oc3-(version).ocmod.zip. A extensão não tem modificações OCMOD, portanto 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. Vá em Extensions > Extensions e escolha o tipo Payments. Localize VibeFox Paytrail Gateway e clique em Install (o botão verde +). Seu usuário administrador precisa ter permissão para modificar a lista de extensões de pagamento.

3. Clique em Edit (o botão do 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. Para testar a extensão primeiro, ative Test mode. Para pagamentos reais, desative-o e informe o seu Merchant ID e a sua Secret key. Não é preciso configurar nenhuma URL de callback na Paytrail.

5. Ative Enable/Disable e clique em Save.

OpenCart 4

1. No painel administrativo, vá em Extensions > Installer, clique em Upload e escolha o arquivo wcp_paytrail_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. Vá em Extensions > Extensions e escolha o tipo Payments. Localize VibeFox Paytrail Gateway, clique em Install (o botão verde +) e depois em Edit (o botão do lápis).

4. Informe a chave de licença e as configurações da Paytrail 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 callback é diferente (veja Pedidos).

Uma nova instalação começa com o método de pagamento desativado e o modo de teste desativado.

Configuração

Todas as configurações ficam na página da extensão: Extensions > Extensions > Payments > VibeFox Paytrail 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 de teste está ativo. Os pagamentos usam a conta de teste pública da Paytrail — nenhum dinheiro real é cobrado. enquanto o modo de teste estiver ativado. No modo de produção, ela avisa se o merchant ID ou a chave secreta estiverem faltando, ou se o merchant ID for a conta de teste pública 375917; nesses casos, a Paytrail não é exibida na finalização de compra. Ela também avisa se a moeda padrão da loja não for EUR: nesse caso, a Paytrail só é exibida quando o cliente paga em EUR. 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 estar vazio nem ter mais de 128 caracteres, 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 precisam existir; caso contrário, nada é salvo. Um merchant ID com qualquer caractere além de dígitos não é salvo: aparece o erro O merchant ID da Paytrail deve conter apenas dígitos. O valor anterior foi mantido. e as demais configurações são salvas.

Paytrail

A seção começa com uma breve nota sobre a página de pagamento da Paytrail e a regra de que o pedido só recebe status depois que a Paytrail confirma o pagamento.

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

Title: o título exibido aos clientes na finalização de compra. Também é o nome do método de pagamento salvo no pedido. Padrão: Paytrail. Obrigatório, no máximo 128 caracteres.

Description: o texto exibido ao cliente na etapa Confirm Order, acima do botão de confirmação, ao lado do ícone da Paytrail. Padrão: Pay securely with Finnish online banking, card, mobile payment or invoice on the Paytrail payment page.

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

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

Credenciais da API

Seu Merchant ID e sua chave secreta são exibidos no Merchant Panel da Paytrail (dados da conta ou da integração). A seção tem um link para a Paytrail. Apenas pagamentos em EUR são aceitos.

Test mode: usa a conta de teste pública da Paytrail (Merchant ID 375917) para os novos pagamentos, em vez das suas credenciais. Nenhum dinheiro real é cobrado, e nenhuma chave é necessária. Os clientes veem Modo de teste: nenhum pagamento real será feito. na etapa Confirm Order. A chave secreta da conta de teste é pública, então qualquer pessoa poderia simular um pagamento feito no modo de teste. Nunca mantenha o modo de teste ativado em uma loja em produção. Padrão: desativado.

Merchant ID: o seu Merchant ID da Paytrail (somente dígitos). É usado quando o modo de teste está desativado. Diferentemente da chave secreta, ele é exibido na página depois de salvar.

Secret key: a sua chave secreta da Paytrail. É usada quando o modo de teste está desativado. A chave salva nunca é exibida novamente. O campo fica vazio e mostra Salva — deixe em branco para mantê-la. Digite um novo valor apenas se quiser alterá-la. Para remover a chave secreta salva, marque Clear saved secret key abaixo do campo e clique em Save.

As callbacks e os reembolsos sempre usam as credenciais do modo em que o pagamento foi feito, então alternar entre teste e produção não quebra os pedidos antigos.

Pedidos

O OpenCart cria o pedido na etapa Confirm Order sem status (um pedido ausente, missing order). O pedido só recebe um status depois que a Paytrail confirma o pagamento. Cada campo de status abaixo lista os seus status de pedido do OpenCart.

Callback URL: mostra a URL pela qual a Paytrail confirma cada pagamento de servidor para servidor. No OpenCart 3 ela tem o formato https://your-store/index.php?route=extension/payment/wcp_paytrail_gateway/callback; no OpenCart 4, https://your-store/index.php?route=extension/wcp_paytrail_gateway/payment/wcp_paytrail_gateway.callback. Ela é enviada com cada pagamento, então nada precisa ser configurado no painel da Paytrail, mas a loja precisa estar acessível pela internet.

Order status after payment: o status de um pedido pago. Padrão: Processing. Selecione Complete se cada pedido pago deve ser concluído imediatamente.

Awaiting payment status: a Paytrail informa o pagamento como pendente ou atrasado (uma fatura ou parcelamento aguardando a aprovação do provedor). O pedido é atualizado automaticamente quando a Paytrail confirma ou rejeita o pagamento. Padrão: Pending.

Payment on hold status: o pagamento precisa da sua atenção (veja Status dos pedidos). 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.

Payment failed status: definido quando um pagamento pendente da Paytrail falha. Padrão: Failed.

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

Avançado

Debug log: registra requisições à API e callbacks em ptg_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 ptg_debug.old.log.php. Dados pessoais e chaves não são registrados. Erros e avisos são sempre 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. Desativar a extensão nunca apaga nada. Os dados de transação da Paytrail dos pedidos são sempre mantidos, pois os reembolsos de pedidos antigos precisam deles. Padrão: desativado.

Importar / Exportar

Export: Download JSON salva as configurações em um arquivo JSON. O merchant ID e a chave secreta não são exportados.

Import: cole um JSON exportado anteriormente e clique em Import para restaurar as configurações. O merchant ID e a chave secreta salvos são mantidos.

Finalização de compra

Na etapa Payment Method, o cliente escolhe o método de pagamento (por padrão, Paytrail). Na etapa Confirm Order, o cliente vê o ícone da Paytrail e a sua descrição. O OpenCart cria o pedido nesta 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 pagamento na Paytrail pelo total do pedido em euros, com o número do pedido como referência, e envia junto as linhas do pedido: produtos com suas opções e impostos, vales-presente comprados, frete e outras cobranças. Cupons, crédito da loja, pontos de recompensa e vales-presente usados são distribuídos entre as linhas. As linhas sempre somam o valor do pagamento; uma diferença de arredondamento é incorporada a uma linha ou enviada como uma linha Rounding. Os dados de contato do cliente são enviados, e os endereços de cobrança e de entrega apenas quando estão completos. O idioma da página de pagamento é finlandês, sueco ou inglês, conforme o idioma do cliente.

O cliente é enviado à página de pagamento da Paytrail, escolhe um método de pagamento habilitado na sua conta Paytrail e paga. A Paytrail então confirma o pagamento duas vezes: devolve o cliente à sua loja e chama a URL de callback de servidor para servidor. As duas confirmações só são aceitas com uma assinatura válida feita com as credenciais daquela tentativa de pagamento, e somente para uma tentativa criada para aquele pedido. O valor pago é comparado com o total do pedido. O pedido só é marcado como pago depois que a Paytrail confirma dessa forma, e então recebe o status da forma padrão do OpenCart, com os e-mails habituais de pedido e a atualização do estoque. A extensão trata estes status da Paytrail:

ok: o pagamento foi feito. O pedido recebe o Order status after payment quando o valor confere.
pending, delayed: o pagamento aguarda o provedor de pagamento, por exemplo a aprovação de uma fatura. O pedido recebe o Awaiting payment status e é atualizado quando a Paytrail confirma ou rejeita o pagamento.
fail: o pagamento falhou ou foi cancelado. Para a última tentativa, o pedido permanece sem status e o cliente pode pagar novamente. Um pedido aguardando recebe o Payment failed status. Pedidos pagos nunca são alterados.

Depois de um pagamento bem-sucedido, o cliente vê a página de sucesso do pedido do OpenCart com Seu pagamento na Paytrail foi recebido. Para um pagamento pendente, a página mostra Seu pagamento na Paytrail está pendente de confirmação pelo provedor de pagamento. O pedido será atualizado automaticamente — por favor, não pague novamente. Se a callback estiver registrando o pagamento exatamente naquele momento, uma página Payment confirmation pede ao cliente que não pague novamente e oferece Check again.

Depois de um pagamento cancelado ou com falha, o cliente volta à finalização de compra com O pagamento na Paytrail foi cancelado ou falhou. Você pode tentar novamente ou escolher outro método de pagamento. Se o pagamento ainda não tiver sido concluído, a mensagem é O pagamento na Paytrail ainda não foi concluído. Você pode tentar novamente ou escolher outro método de pagamento. O carrinho é mantido. No OpenCart 4 essas mensagens são exibidas acima da página de finalização de compra. Um retorno que não pode ser verificado mostra uma página Payment Error com Payment verification failed. e não altera nada.

Se a Paytrail não conseguir iniciar o pagamento, o cliente permanece na etapa Confirm Order com uma breve mensagem acima do botão, por exemplo Não foi possível conectar à Paytrail. Tente novamente em instantes., A Paytrail está temporariamente indisponível. Escolha outro método de pagamento. (credenciais incorretas) ou A Paytrail não conseguiu iniciar o pagamento. Verifique seus dados de cobrança e tente novamente, ou escolha outro método de pagamento. O motivo técnico é registrado no log. Um total fora dos limites da Paytrail mostra Este total de pedido não pode ser pago com a Paytrail. Escolha outro método de pagamento.

No OpenCart 3, um novo pedido é criado sempre que a etapa Confirm Order é exibida; no OpenCart 4, o pedido do checkout é atualizado (uma nova tentativa paga o mesmo pedido). Se o carrinho já tiver sido pago com outro pedido, o cliente vai direto à página de sucesso e nenhum novo pagamento é iniciado. Um pagamento na Paytrail não pode ser cancelado pela API, então uma página de pagamento anterior continua pagável. Se o cliente pagar também essa, o segundo pagamento é registrado no pedido pago como um duplicado a ser reembolsado, e o outro pedido permanece sem status. Uma alteração do carrinho, inclusive uma nova quantidade, conta como um novo carrinho que precisa de um pagamento próprio.

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 sem pagamento nesse meio tempo (por exemplo, se você o cancelou), o cliente volta à finalização de compra com a mensagem Seu pedido anterior foi cancelado ou reembolsado. Confirme o pedido novamente para pagar com um novo pedido. Se o pagamento pendente desse pedido falhou, a mensagem é O pagamento na Paytrail foi cancelado ou falhou. Você pode tentar novamente ou escolher outro método de pagamento. O próximo Confirm Order paga um novo pedido. 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, e o próximo Confirm Order paga um novo pedido do carrinho atual. Um pedido fechado nunca é mostrado como pago.

A callback também funciona enquanto a loja está em modo de manutenção, porque o OpenCart deixa passar as requisições das extensões de pagamento (no OpenCart 4, a extensão adiciona sua própria ação de inicialização para isso, que também deixa passar o retorno do cliente da Paytrail).

O cliente escolhe o método de pagamento na página da Paytrail, não na sua finalização de compra. A extensão não tem tokenização de cartão nem cartões salvos, assinaturas, shop-in-shop, ativação manual de faturas nem relatórios de liquidação.

Pedidos e reembolsos

Status dos pedidos

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

Order status after payment (padrão Processing): o pagamento foi confirmado. Uma nota mostra a transação da Paytrail, o método de pagamento usado na Paytrail e o valor, com TEST mode — no real money. para pagamentos de teste.

Awaiting payment status (padrão Pending): o pagamento está pendente no provedor (fatura ou pagamento atrasado). O pedido passa ao status de pago quando a Paytrail confirma o pagamento, ou ao status de falha quando o pagamento falha.

Payment on hold status (padrão Pending): o valor pago difere do total do pedido (o valor realmente pago é registrado), o pagamento chegou depois que o pedido foi colocado em outro status, por exemplo cancelado, ou um pagamento de teste foi recebido enquanto a extensão estava no modo de produção (sem dinheiro real, nada a reembolsar). A nota explica o motivo. Verifique o pedido e, em seguida, atenda-o ou reembolse o pagamento.

Payment failed status (padrão Failed): um pagamento pendente na Paytrail falhou ou foi cancelado.

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

Callbacks repetidas ou simultâneas são aplicadas uma única vez, sem notas duplicadas. Um pedido pago, reembolsado ou concluído nunca é reaberto por uma callback posterior. Se uma segunda tentativa de um pedido ou carrinho já pago for paga, o pedido não é alterado; uma nota Duplicate payment pede que você a reembolse no Merchant Panel da Paytrail.

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

Aba VibeFox Paytrail Gateway

Em Sales > Orders, abra um pedido pago com a Paytrail. Na parte inferior da página do pedido, ao lado de History e Additional, a aba VibeFox Paytrail Gateway lista as tentativas de pagamento do pedido (data, transação e carimbo da Paytrail com o rótulo Test para pagamentos de teste, valor, método de pagamento, status e resultado na Paytrail), os valores Paid / refunded, o formulário de reembolso, o histórico de reembolsos e as Paytrail notes do pedido. A aba é mostrada aos usuários que têm acesso à extensão.

Reembolsos

Na aba VibeFox Paytrail Gateway, informe o Amount (o valor ainda não reembolsado é preenchido), opcionalmente um motivo para a nota do pedido, e clique em Refund via Paytrail. Confirme a pergunta Reembolsar este valor pela Paytrail? Esta ação não pode ser desfeita. Reembolsos totais e parciais são aceitos, apenas por valor. Você precisa ter o direito de modificar a extensão (definido em System > Users > User Groups). Você pode reembolsar até o valor que a Paytrail efetivamente cobrou; portanto, depois de uma divergência de valor, o limite é o que o cliente pagou, e não o total do pedido. O reembolso usa as credenciais do modo em que o pagamento foi feito, então, para um pagamento em produção, as credenciais de produção precisam estar configuradas. Os reembolsos ficam disponíveis assim que a Paytrail confirma o pagamento.

Se o método de pagamento não aceitar reembolsos diretos, a extensão inicia automaticamente um reembolso por e-mail: a Paytrail envia um e-mail ao cliente para que ele informe uma conta bancária. Isso exige o e-mail do cliente no pedido. A nota indica qual tipo de reembolso foi iniciado.

Um reembolso pode ser concluído na hora ou processado depois. A confirmação posterior da Paytrail é adicionada como nota. Se a Paytrail não conseguir concluir o reembolso, uma nota informa que o dinheiro não foi devolvido ao cliente, e o reembolso deixa de contar como reembolsado; devolva o valor ao cliente por outro meio. Se a Paytrail rejeitar o reembolso imediatamente, a aba mostra o erro e nenhum reembolso é registrado. Um reembolso total define o pedido como Refunded status sem notificar o cliente e sem devolver os produtos ao estoque, como uma alteração manual de status. Um reembolso parcial não altera o status.

As devoluções de produtos em Sales > Returns não devolvem dinheiro pela Paytrail. Os reembolsos feitos no Merchant Panel da Paytrail não são sincronizados com o OpenCart.

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 Paytrail Gateway é o primeiro bloco em Extensions > Extensions > Payments > VibeFox Paytrail 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-paytrail 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 administrativo (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 com 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 único domínio: o endereço da loja nas configurações 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 Paytrail 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 administrativo 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 painel administrativo, 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 administrativo. Feche-o com × para ocultá-lo por 7 dias. Os pedidos existentes não são afetados: pagamentos já iniciados continuam sendo confirmados pelas callbacks e pelo retorno do cliente, e os reembolsos funcionam.

Quando uma licença expira, a extensão continua funcionando, mas atualizações e suporte precisam de renovação. O status é verificado novamente de forma automática quando você abre o Dashboard ou a página Edit do painel administrativo: uma vez por dia nos primeiros 14 dias após a chave ser informada, 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 Paytrail não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ativado e se o Test mode está ativado ou se o Merchant ID e a Secret key estão preenchidos (e não é a conta de teste pública 375917). Verifique se o cliente paga em EUR, 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 mostra um aviso para credenciais ausentes e para uma moeda da loja diferente de EUR.

O pagamento foi feito, mas o pedido continua sem status: a callback não consegue chegar à sua loja, e o cliente não voltou à loja. A Callback URL exibida na seção Orders precisa ser acessível pela internet (sem autenticação básica nem firewall no caminho).

A callback ou o retorno responde Payment verification failed.: a assinatura é inválida, ou o pagamento não pertence a nenhuma tentativa de pagamento do pedido. Nada é alterado. Verifique se a Secret key está correta e pertence ao Merchant ID.

A callback responde Temporarily unavailable: o pedido estava sendo confirmado por outra requisição no mesmo momento, ou o status do pedido não pôde ser definido. A Paytrail chama novamente. Veja o campo Log para o motivo.

O cliente vê um erro depois de Confirm Order: veja o campo Log na página da extensão. Por exemplo, Paytrail API error (401) indica credenciais incorretas. Ative o Debug log para mais detalhes. This payment method is not available. Please reload the checkout page. significa que o método de pagamento foi desativado nesse meio tempo ou que a finalização de compra não corresponde mais ao pedido.

O merchant ID não é salvo: ele deve conter apenas dígitos. Copie-o novamente do Merchant Panel da Paytrail.

O pedido está no status de espera (on hold): leia as notas na aba VibeFox Paytrail Gateway. O motivo pode ser um valor pago diferente, um pagamento depois de uma mudança de status ou um pagamento de teste no modo de produção.

O reembolso falha: leia a mensagem. This order has no confirmed Paytrail payment. Refund it manually. significa que não há pagamento confirmado na Paytrail para reembolsar. The live Paytrail credentials used for this payment are missing. Enter them in the Paytrail settings. significa que o pagamento foi feito no modo de produção e as credenciais de produção não estão definidas. Invalid refund amount: at most … significa que o valor é maior do que o que resta a reembolsar. This payment method supports only e-mail refunds, but the order has no billing e-mail. significa que o pedido precisa do e-mail do cliente.

Para desenvolvedores: antes de a requisição de pagamento ser assinada e enviada, a extensão dispara o evento do OpenCart ptg_payment_request com a requisição e o pedido.

Desinstalação

Vá em Extensions > Extensions, escolha o tipo Payments e clique em Uninstall (o botão vermelho −) ao lado de VibeFox Paytrail 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 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 deixa passar a callback 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, merchant ID, chave secreta, registro de log) e o log são removidos. Se estiver desativado, elas são mantidas para uma futura reinstalação. As transações e os reembolsos da Paytrail são sempre mantidos, então pedidos pagos antes ainda podem ser reembolsados após uma reinstalação. Os pedidos existentes mantêm suas notas de pagamento.

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

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