VibeFox Worldline for OpenCart — Ajuda
Requisitos
OpenCart: 3.0.x (testado na 3.0.5.0) ou 4.0.2 e superior (testado na 4.1.0.3).
PHP: 8.0 ou superior.
Conta Worldline: uma conta de comerciante da Worldline Direct (antes Ingenico Direct). As contas de teste e real são separadas e têm credenciais diferentes. Para cada conta você precisa do Merchant ID (seu PSPID), de um API Key ID com a respectiva Secret API Key e de uma chave de webhook com seu segredo. Todas são criadas no Worldline Merchant Portal (veja Configuração).
Chave de licença VibeFox: comprada 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 para o OpenCart 3 wcp_worldline_gateway-oc3-(version).ocmod.zip e o pacote para o OpenCart 4 wcp_worldline_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 admin, vá em Extensions > Installer, clique em Upload e escolha o arquivo wcp_worldline_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. Vá em Extensions > Extensions e escolha o tipo Payments. Encontre VibeFox Worldline 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 de lápis) para abrir a página de configurações. Insira 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. Insira as credenciais de teste, clique em Save e depois em Test credentials.
5. Adicione a URL do webhook no Merchant Portal da conta de teste e informe a chave e o segredo do webhook (veja Configuração).
6. Ative Enable/Disable, salve e faça um pagamento de teste. Depois, insira as credenciais reais, repita a configuração do webhook na sua conta real, clique em Live credentials e desative Test Mode.
OpenCart 4
1. No admin, vá em Extensions > Installer, clique em Upload e escolha o arquivo wcp_worldline_gateway.ocmod.zip. Não renomeie o arquivo: o OpenCart 4 obtém o código da extensão 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 Worldline Gateway, clique em Install (o botão verde +) e depois em Edit (o botão de lápis).
4. Informe a chave de licença, as credenciais e o webhook como nos passos 3 a 6 para o OpenCart 3. A página de configurações e os seus campos são iguais nas duas versões. Só a URL do webhook é diferente (veja Webhooks).
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 Worldline Gateway > Edit. As seções são listadas à esquerda; o botão Save abaixo da lista salva a página inteira. Acima das configurações, a página avisa quando as credenciais do modo atual (Merchant ID, API Key ID, Secret API Key) estão incompletas, porque o método de pagamento fica então oculto no checkout. Enquanto o modo de teste estiver ativo, ela mostra Test mode is on (pre-production environment): no real money is charged. Sem a permissão para 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 (no máximo 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 devem existir. Caso contrário, nada é salvo e a página indica o campo. Credenciais incompletas não impedem o salvamento.
Worldline (Ingenico)
Enable/Disable: Enable Worldline Gateway ativa ou desativa o método de pagamento. Padrão: desativado.
Title: o nome do método de pagamento que os clientes veem no checkout. É também o nome do método de pagamento armazenado no pedido. Padrão: Worldline. Obrigatório, até 128 caracteres.
Description: o texto mostrado ao cliente na etapa Confirm Order, acima do botão de confirmação. Padrão: Pay securely via Worldline.
Sort Order: a posição da Worldline entre os métodos de pagamento no checkout. Deixe em branco ou digite um número inteiro.
Geo Zone: oferece a Worldline 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 do checkout, na moeda padrão da loja, que um pedido precisa atingir para que a Worldline seja oferecida. Deixe em branco para oferecer a Worldline para qualquer total.
API Worldline Direct
Obtenha as credenciais no Worldline Merchant Portal da conta de teste e da conta real. Seu PSPID é o Merchant ID. Em Developer > Payment API são criados o API Key ID e a Secret API Key; em Developer > Webhooks, a chave e o segredo do webhook. A seção tem links para os dois portais e para a documentação da Worldline.
Test Mode: troca ao mesmo tempo o endpoint da API e as credenciais. O modo de teste usa o ambiente de pré-produção e as credenciais de teste; o modo real, o ambiente de produção e as credenciais reais. Padrão: ativado. Desative para cobrar pagamentos reais. Enquanto o modo de teste estiver ativo, os clientes veem Test mode — no real money is charged. na etapa Confirm Order.
Conta de teste (pré-produção)
Test Merchant ID (PSPID): o PSPID da sua conta de teste.
Test API Key ID: o API Key ID criado em Developer > Payment API da conta de teste.
Test Secret API Key: a Secret API Key que pertence a esse API Key ID.
Test Webhook Key ID: opcional. Se informada, somente webhooks enviados com esta chave são aceitos.
Test Webhook Secret: o segredo do webhook da conta de teste. Ele é usado para verificar a assinatura de cada webhook.
Conta real (produção)
Live Merchant ID (PSPID): o PSPID da sua conta real.
Live API Key ID: o API Key ID criado em Developer > Payment API da conta real.
Live Secret API Key: a Secret API Key que pertence a esse API Key ID.
Live Webhook Key ID: opcional. Se informada, somente webhooks enviados com esta chave são aceitos.
Live Webhook Secret: o segredo do webhook da conta real.
Chaves secretas e segredos de webhook salvos nunca são exibidos novamente. O campo fica vazio e mostra Saved — leave empty to keep it. Digite um novo valor somente se quiser alterá-lo. Para remover um valor salvo, marque Clear the saved value abaixo do campo e clique em Save.
Verificar credenciais: os botões Test credentials e Live credentials verificam as credenciais salvas de cada conta com uma chamada de teste à Worldline. Salve suas alterações primeiro. A resposta aparece abaixo dos botões, por exemplo Test credentials: connection successful., API credentials are not configured. ou o erro retornado pela Worldline.
Webhooks
O webhook informa sua loja sobre os pagamentos mesmo quando o cliente não volta à loja, por exemplo depois de fechar o navegador ou quando um pagamento é confirmado mais tarde. No Merchant Portal, abra Developer > Webhooks da conta de teste e adicione a URL mostrada em Endpoint URL nesta seção. No OpenCart 3 ela tem este formato: https://your-store/index.php?route=extension/payment/wcp_worldline_gateway/webhook, e no OpenCart 4: https://your-store/index.php?route=extension/wcp_worldline_gateway/payment/wcp_worldline_gateway.webhook. Ela é montada a partir do endereço da loja da sua instalação do OpenCart. Copie a URL exatamente como as configurações a mostram: ela precisa responder sem redirecionamentos e estar acessível pela internet. Depois, informe o ID e o segredo da chave do webhook em Test Webhook Key ID e Test Webhook Secret. Faça o mesmo na conta real, com os campos reais.
A extensão responde automaticamente à requisição de verificação do endpoint da Worldline. Ela processa eventos de pagamento (mudanças de status dos pagamentos) e eventos de reembolso (mudanças de status dos reembolsos). Outros eventos são aceitos e ignorados. Webhooks sem assinatura válida são rejeitados. Um evento precisa ser assinado com o segredo da conta em que o pagamento foi feito, então um webhook de teste nunca confirma um pagamento real. Um webhook também é ignorado quando vem de um Merchant ID diferente do da conta cujo segredo o assinou. Sem o webhook, um pedido só é confirmado quando o cliente volta à loja depois de pagar.
Página de pagamento e pedidos
Payment page template: nome opcional de um modelo de checkout hospedado (variante) enviado ao Merchant Portal, por exemplo SimplifiedCustomPaymentPage. Deixe em branco para a página padrão da Worldline.
Order Status After Payment: qual status um pagamento capturado define. Os pagamentos são sempre solicitados como venda direta (autorização e captura).
O OpenCart cria o pedido na etapa Confirm Order sem status (um pedido ausente). O pedido só recebe um status depois que a Worldline confirma o pagamento. Cada campo abaixo lista os seus status de pedido do OpenCart.
Paid Order Status: o status após um pagamento capturado com Payment accepted (processing). Padrão: Processing.
Complete Order Status: o status após um pagamento capturado com Delivered (completed). Padrão: Complete.
Awaiting Capture Status: o pagamento está autorizado ou a captura foi solicitada; o webhook de captura marca o pedido como pago. Padrão: Pending.
On Hold (Review) Status: o valor ou a moeda pagos não correspondem ao pedido. Uma observação explica o motivo. Padrão: Pending, porque o OpenCart não tem o status On hold. Você pode criar seus próprios status em System > Localisation > Order Statuses e selecioná-los aqui.
Payment Error Status: a Worldline recusou ou cancelou o pagamento de um pedido que aguardava a captura. Padrão: Failed.
Refunded Status: o pagamento foi totalmente reembolsado pela página do pedido. Padrão: Refunded.
Avançado
Logging: grava todas as requisições à API e os webhooks em wlg_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 wlg_debug.old.log.php. Erros e avisos são sempre registrados, mesmo quando esta opção está desativada. Chaves, dados de cartão e dados pessoais são mascarados. Padrão: desativado.
Log: mostra o tamanho e as entradas mais recentes do log. Clique em Clear log para esvaziá-lo.
Delete Data: quando ativado, desinstalar a extensão remove as configurações do gateway e o log. As transações e os reembolsos da Worldline são sempre mantidos, porque os pedidos existentes precisam deles para reembolsos. Padrão: desativado.
Import / Export
Export: Download JSON salva as configurações em um arquivo JSON. Chaves secretas e segredos de webhook não são exportados.
Import: cole um 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, Worldline). Na etapa Confirm Order, o cliente vê a sua descrição. O OpenCart cria o pedido nesta etapa, ainda sem status. Quando o cliente clica em Confirm Order, a extensão cria um checkout hospedado da Worldline pelo total do pedido na moeda do pedido e envia o cliente à página de pagamento da Worldline. Lá o cliente paga com cartão, carteira digital ou outro método de pagamento ativado na sua conta Worldline. Nome de cobrança, endereço, e-mail e telefone são repassados à Worldline, e a página de pagamento abre no idioma do cliente quando a Worldline oferece suporte a ele. Cada tentativa de pagamento recebe sua própria referência, formada pelo número do pedido e uma parte aleatória. 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 na parte de baixo da página de finalização da compra.
Depois de pagar, o cliente volta à sua loja. A extensão confere o retorno com a tentativa armazenada e lê o status do pagamento na Worldline, no servidor. O pedido só é marcado como pago depois que a Worldline confirma, seja por essa verificação de status, seja por um webhook assinado. Em seguida, o pedido recebe seu status da forma padrão do OpenCart, com os e-mails habituais do pedido e a atualização do estoque, e o cliente vê a página de sucesso do pedido do OpenCart com Your payment with Worldline has been received. Se o pagamento estiver autorizado, mas ainda não capturado, a página mostra Your payment is authorized. The order is confirmed as soon as Worldline confirms the capture. Se o pagamento desse pedido falhar, a página mostra Your Worldline payment was not completed. Please contact us about this order.
Se o pagamento não foi concluído, o pedido não mantém nenhum status, o carrinho é preservado e o cliente volta ao checkout com uma mensagem:
Se o status ainda não puder ser verificado, uma página de Payment confirmation mostra We could not confirm your payment yet. If you completed the payment, please do not pay again — you will receive a confirmation as soon as Worldline confirms it. com os botões Check again e Back to checkout. O webhook define o status do pedido assim que chega.
No OpenCart 4 essas mensagens são exibidas acima da página de finalização da compra.
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, por isso, após um cancelamento ou uma recusa, o cliente paga o mesmo pedido em uma nova página de pagamento da Worldline. Antes de um novo pagamento, a extensão verifica o carrinho: se outro pedido do mesmo carrinho já estiver pago, ou se a tentativa anterior tiver sido paga entretanto, o cliente vai direto à página de sucesso e não é cobrado duas vezes. Se a página de pagamento anterior do mesmo pedido ainda estiver aberta, para o mesmo valor e modo, e tiver sido criada há menos de 30 minutos, o cliente é levado de volta a ela.
No OpenCart 4, se o pagamento do pedido do checkout foi recusado ou cancelado após a autorização, o próximo Confirm Order envia o cliente de volta à finalização da compra com a mensagem sobre o pagamento recusado, em vez da página de sucesso. Se a loja fechou esse pedido (por exemplo, cancelou ou reembolsou), a mensagem é Your previous order was closed by the shop (cancelled / refunded). Please confirm the order again to pay with a new order. Nos dois casos, o próximo 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 volta à finalização da compra e o novo carrinho é pago com um novo pedido.
Se a Worldline não puder iniciar o pagamento, o cliente permanece na etapa Confirm Order com a mensagem Payment error: Could not create checkout session. Please try again. acima do botão. O motivo é registrado no log. Se faltarem as credenciais do modo atual, o cliente vê This payment method is not available at the moment. Please choose another payment method.
O webhook e o retorno do cliente também funcionam 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 para elas.
A extensão aceita pagamentos únicos como venda direta na página da Worldline. Não há tokenização nem cartões salvos, nem assinaturas, nem formulário de cartão incorporado, nem modo somente de autorização com captura ou cancelamento pelo OpenCart, nem acréscimo de taxa, nem registro automático de webhooks.
Pedidos e reembolsos
Status de pedido
Sem status (pedido ausente): o cliente foi enviado à Worldline e não pagou, ou a Worldline ainda não confirmou o pagamento. Em Sales > Orders, esses pedidos aparecem apenas com o filtro Order Status definido como Missing Orders.
Paid Order Status ou Complete Order Status (padrão Processing ou Complete): o pagamento foi capturado. O status segue o Order Status After Payment. Uma observação mostra o valor, o ID do pagamento na Worldline e como ele foi confirmado (webhook assinado ou verificação de status).
Awaiting Capture Status (padrão Pending): a Worldline informa que o pagamento está autorizado ou que a captura foi solicitada, mas ainda não capturada. O pedido passa ao status pago quando o webhook confirma a captura. Se a observação disser que o pagamento não foi capturado, capture-o no Worldline Merchant Portal.
On Hold (Review) Status (padrão Pending): o pagamento não corresponde ao pedido, por exemplo porque o valor ou a moeda diferem, ou porque o pagamento pertence a outra tentativa. A observação mostra o valor pago, o total do pedido e a referência. Confira o pedido e atenda-o, ou reembolse o pagamento.
Payment Error Status (padrão Failed): a Worldline recusou ou cancelou o pagamento de um pedido que aguardava a captura.
Refunded Status (padrão Refunded): o pagamento foi totalmente reembolsado pela extensão.
Se chegar um pagamento para um pedido cancelado ou reembolsado, o pedido não é reaberto. Uma observação pede que você cancele ou reembolse o pagamento no Worldline Merchant Portal, ou restaure o pedido manualmente. O cliente que volta vê Your payment was received after this order had been cancelled. Please contact us — we will restore the order or refund the payment. Se chegar um segundo pagamento para um pedido que já está pago, ou para outro pedido de um carrinho já pago, o pedido não é alterado. Uma observação no pedido pago pede que você reembolse o segundo pagamento no Worldline Merchant Portal.
As observações são entradas do History do pedido que o cliente não vê. Elas começam com a palavra Worldline.
Aba VibeFox Worldline Gateway
Em Sales > Orders, abra um pedido pago com a Worldline. Na parte inferior da página do pedido, ao lado de History e Additional, a aba VibeFox Worldline Gateway mostra o bloco Worldline payment: o Payment ID, a Merchant reference, o Hosted checkout, o Status da tentativa, o Amount charged / refunded, um rótulo Test environment para pagamentos de teste, o formulário de reembolso, o histórico de reembolsos e as Payment notes do pedido. A aba é mostrada aos usuários que têm acesso à extensão.
Reembolsos
Na aba VibeFox Worldline Gateway, informe o valor (o valor ainda não reembolsado é preenchido), opcionalmente um Reason (optional), e clique em Refund via Worldline. Confirme a pergunta Refund this amount through Worldline? This cannot be undone. Reembolsos totais e parciais são suportados. O pagamento precisa estar capturado. Você precisa da permissão para modificar a extensão (definida em System > Users > User Groups). Os reembolsos são feitos no valor e na moeda cobrados pela Worldline; 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 reembolso é sempre enviado ao ambiente do pagamento original (teste ou real), com as credenciais dessa conta, que portanto precisam estar preenchidas. Um reembolso reenviado após um tempo limite não é executado duas vezes, e apenas um reembolso de cada pedido é executado por vez. Se a Worldline recusar o reembolso, a aba mostra o erro e nenhum reembolso é registrado. Um reembolso aceito é adicionado ao histórico de reembolsos e às observações, com o ID e o status do reembolso na Worldline. 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 Worldline.
As mudanças de status dos reembolsos chegam da Worldline por webhook, atualizam o histórico de reembolsos e são adicionadas às observações. Reembolsos feitos no Merchant Portal não alteram o status do pedido; atualize-o manualmente, se necessário.
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 Worldline Gateway é o primeiro bloco em Extensions > Extensions > Payments > VibeFox Worldline Gateway > Edit, acima das configurações. Insira a chave em License key e clique em Activate. Depois, 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 inserir outra chave e Remove key para remover a chave desta loja. Abaixo deles ficam a linha Product: opencart-payment-worldline e o link Manage licenses and domains in your account, que abre sua conta vibefox.net. Somente usuários administradores com a permissão Modify da 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 único 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 vibefox.net.
Sem uma chave ativa, a Worldline não é mostrada aos clientes no checkout. Se mesmo assim um pagamento for iniciado, o cliente vê This payment method is not available. Please choose another one. Um usuário administrador que esteja conectado ao painel 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 administrador, por isso, sem uma chave ativa, o método de pagamento fica oculto para todos. Depois que você abrir a página Edit uma vez, aparece um lembrete no Dashboard do painel. Feche-o com × para ocultá-lo por 7 dias. Os pedidos existentes não são afetados: os 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 precisam de uma renovação. O status é verificado novamente de forma automática quando você abre o Dashboard do admin ou a página Edit: uma vez por dia nos primeiros 14 dias após a chave ser inserida, depois uma vez por semana. Não é necessária nenhuma tarefa cron. Desinstalar a extensão sempre remove a chave de licença e o status da licença.
Solução de problemas
A Worldline não aparece no checkout: verifique se a licença está ativa, se Enable/Disable está ativado e se o modo atual tem Merchant ID, API Key ID e Secret API Key preenchidos: os campos de teste no modo de teste, os campos reais no modo real. A página de configurações mostra um aviso quando estão faltando. Verifique também se o endereço de pagamento está na Geo Zone selecionada e se o pedido atinge o Total configurado.
O pagamento foi feito, mas o pedido continua sem status: o webhook não está funcionando. No Merchant Portal da conta que você usa (teste ou real), verifique se o endpoint existe e se a URL é exatamente a mostrada em Endpoint URL, sem redirecionamentos. Verifique se o segredo do webhook dessa conta está no campo correspondente (Test Webhook Secret ou Live Webhook Secret) e se o campo do ID da chave do webhook está vazio ou coincide com a chave. O pedido também recebe o status quando o cliente volta à loja depois de pagar.
O webhook responde Webhook secret not configured: nenhum dos segredos do webhook está definido. Informe o segredo do webhook nas configurações. A Worldline tenta o webhook novamente.
O webhook responde Invalid signature: o segredo do webhook pertence a outra conta ou outra chave, ou o ID da chave do webhook não corresponde à chave que enviou o webhook. Verifique se os segredos de teste e real não foram trocados.
O webhook responde Missing signature, Empty body ou Invalid JSON: a requisição não veio da Worldline no formato esperado, ou um proxy ou redirecionamento a alterou. Verifique se a URL responde sem redirecionamentos.
O webhook responde Ignored: o webhook veio de um Merchant ID diferente do configurado para esse modo. Verifique Test Merchant ID (PSPID) ou Live Merchant ID (PSPID).
O webhook responde Retry later: o pedido estava sendo confirmado por outra requisição no mesmo momento, ou não foi possível definir o status do pedido. A Worldline tenta o webhook novamente. Veja o campo Log para o motivo.
A URL do webhook mostra Method not allowed no navegador: isso é normal. A URL aceita somente requisições da Worldline.
Test credentials ou Live credentials mostra um erro: salve as configurações primeiro e depois verifique se o Merchant ID, o API Key ID e a Secret API Key vêm da mesma conta, e se os valores de teste estão nos campos de teste e os valores reais nos campos reais.
O cliente vê um erro depois de Confirm Order: veja o campo Log na página da extensão. Os erros são registrados mesmo quando Logging está desativado. Para ver todos os detalhes das requisições, ative Logging e tente novamente.
Pagamentos de teste não confirmam um pagamento real: teste e real são mantidos separados. Altere Test Mode para o modo que deseja usar e utilize as credenciais e o webhook dessa conta.
O pedido está no status de análise ou aguardando captura depois do pagamento: leia as observações na aba VibeFox Worldline Gateway (veja Status de pedido). Ou a Worldline ainda não confirmou a captura (o webhook completa o pedido), ou o valor ou a moeda pagos diferiram do pedido.
Não há formulário de reembolso na aba: a aba informa o motivo: não há pagamento capturado na Worldline, o pagamento foi totalmente reembolsado, seu grupo de usuários não tem permissão para modificar a extensão, ou as credenciais do ambiente do pagamento não estão definidas.
O reembolso falha com uma mensagem sobre o ambiente: o pagamento foi feito no ambiente de teste ou real, e as credenciais desse ambiente não estão definidas. Informe-as e tente novamente.
Para desenvolvedores: antes de o checkout hospedado ser criado, a extensão dispara o evento do OpenCart wlg_hosted_checkout_data com os dados da requisição e o pedido, por exemplo para limitar os métodos de pagamento exibidos.
Desinstalação
Vá em Extensions > Extensions, escolha o tipo Payments e clique em Uninstall (o botão vermelho −) ao lado de VibeFox Worldline 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 Payment page and 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 o webhook e o retorno do cliente no modo de manutenção). Se Delete Data estiver ativado, as demais configurações do gateway (título, descrição, modo de teste, credenciais, segredos de webhook, modelo de página, registro) e o log são removidos. Se estiver desativado, elas são mantidas para uma reinstalação posterior. As transações e os reembolsos da Worldline 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, vá em Extensions > Installer após a desinstalação e clique em Uninstall (o botão laranja −) ao lado de VibeFox Worldline Gateway na lista de extensões instaladas, depois em Delete (o botão vermelho com lixeira) para remover o pacote enviado.
Worldline é uma marca registrada de seu respectivo titular. Esta extensão não é afiliada nem endossada pela Worldline.