VibeFox KOMOJU for OpenCart — Ajuda

Requisitos

OpenCart: 3.0.x (testado na versão 3.0.5.0) ou 4.0.2 e superior (testado na versão 4.1.0.3).

PHP: 8.0 ou superior.

Conta KOMOJU: você precisa da chave secreta (sk_live_... e, para o modo de teste, sk_test_...) e do token secreto de um webhook criado no painel da KOMOJU (consulte Configuração). A chave pública não é necessária. A KOMOJU precisa conseguir acessar a URL do webhook da sua loja.

Moeda do pedido: JPY, USD, EUR, TWD, KRW, PLN, GBP, HKD, SGD, NZD, AUD, IDR, MYR, PHP, THB, CNY, BRL, CHF, CAD ou VND. Para pedidos em outras moedas, o método de pagamento fica oculto.

Chave de licença VibeFox: comprada 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 para OpenCart 3 wcp_komoju_payment-oc3-(version).ocmod.zip e o pacote para OpenCart 4 wcp_komoju_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_komoju_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, escolha o tipo Payments, encontre VibeFox KOMOJU Payment e clique em Install (o botão verde +). Seu usuário administrador precisa ter o direito de 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. Cole sua chave de licença VibeFox em License key, no bloco de licença no topo da página, e clique em Activate (consulte Chave de licença).

4. No painel da KOMOJU, adicione um webhook com a URL e os eventos mostrados na seção Webhook URL, e copie o token secreto dele (consulte Configuração).

5. Informe a chave secreta de produção e o token secreto do webhook de produção, além das chaves de teste para o modo sandbox. Ative Enable/Disable e clique em Save.

OpenCart 4

1. No admin, acesse Extensions > Installer, clique em Upload e escolha o arquivo wcp_komoju_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, escolha o tipo Payments, encontre VibeFox KOMOJU Payment, clique em Install (o botão verde +) e depois em Edit (o botão de lápis).

4. Informe a chave de licença, o webhook e as chaves como nos passos 3 a 5 para o OpenCart 3. A página de configurações e os seus campos são iguais nas duas versões. Apenas a URL do webhook é diferente (veja URL do webhook).

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

Configuração

Todas as configurações estão na página da extensão: Extensions > Extensions > Payments > VibeFox KOMOJU Payment > 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 mostra KOMOJU Sandbox Mode is enabled. enquanto o modo de teste estiver ativo. Ela avisa quando o modo atual não tem chave secreta (nesse caso, o método de pagamento fica oculto no checkout) ou token secreto do webhook (as notificações da KOMOJU são rejeitadas, e pagamentos por konbini e transferência bancária nunca são confirmados), e quando a KOMOJU não aceita a moeda padrão da loja (nesse caso, o método de pagamento fica oculto para pedidos nessa moeda). Sem o direito de modificar a extensão, a página mostra as configurações, mas não consegue salvá-las.

Ao salvar, Title deve ter 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 precisam existir. Caso contrário, nada é salvo e a página indica o campo. Chaves faltando não impedem o salvamento.

Método de pagamento KOMOJU

Enable/Disable: Enable KOMOJU Payment Gateway liga ou desliga o método de pagamento. Padrão: desativado.

Title: o nome do método de pagamento que o cliente vê no checkout. É também o nome do método de pagamento salvo no pedido. Padrão: KOMOJU Payment. Se você deixar vazio, o nome padrão é usado. 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 securely on the KOMOJU payment page: credit card, convenience store (konbini), PayPay, bank transfer and other local payment methods.

Sort Order: a posição da KOMOJU entre os métodos de pagamento no checkout. Deixe vazio ou informe um número inteiro.

Geo Zone: oferece a KOMOJU 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 antes de a KOMOJU ser oferecida. Deixe vazio para oferecer a KOMOJU para qualquer valor.

Chaves de API de produção

Encontre as chaves no painel da KOMOJU (lá há links para as seções): a chave secreta em Settings > API keys, e o token secreto do webhook em Settings > Webhooks (adicione antes ali a URL do webhook mostrada na seção Webhook URL).

Live Secret Key: sua chave secreta de produção da KOMOJU. Ela começa com sk_live_.

Live Webhook Secret Token: o token secreto do webhook de produção. Ele é usado para verificar a assinatura de cada notificação.

Modo de teste

A KOMOJU usa o mesmo endereço de API para pagamentos de teste e reais: a chave define o modo. Os pagamentos mantêm o modo em que foram feitos, então reembolsos e consultas de status de um pedido sempre usam a chave desse modo.

Sandbox Mode: Enable test mode (use the test keys below, no real payments). Padrão: desativado. Enquanto estiver ativo, a etapa Confirm Order mostra Test mode acima da descrição.

Sandbox Secret Key: sua chave secreta de teste da KOMOJU. Ela começa com sk_test_.

Sandbox Webhook Secret Token: o token secreto do webhook do modo de teste.

Chaves e tokens 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 on save abaixo do campo e clique em Save.

URL do webhook

O webhook informa à sua loja sobre os pagamentos, incluindo os pagamentos postergados por konbini e transferência bancária. No painel da KOMOJU, em Settings > Webhooks, adicione a URL mostrada nesta seção, tanto para o modo de produção quanto para o de teste. No OpenCart 3 ela tem o formato https://your-store/index.php?route=extension/payment/wcp_komoju_payment/webhook; no OpenCart 4, https://your-store/index.php?route=extension/wcp_komoju_payment/payment/wcp_komoju_payment.webhook. Ela é montada a partir do endereço da vitrine da sua instalação do OpenCart. Copie a URL exatamente como as configurações a mostram. Depois, copie o token secreto de cada webhook para Live Webhook Secret Token ou Sandbox Webhook Secret Token.

Selecione estes eventos (também estão listados nesta seção):

Os eventos de expiração, cancelamento e falha alteram o pedido somente em relação ao pagamento atual, para que um pagamento de uma tentativa anterior não possa cancelar um pedido que está sendo pago de outra forma. Webhooks sem assinatura válida são rejeitados. Webhooks assinados com qualquer um dos dois tokens secretos são aceitos, mas somente para pagamentos do mesmo modo. Sem o webhook, pagamentos com cartão continuam sendo confirmados quando o cliente volta à loja, mas pagamentos por konbini e transferência bancária nunca são confirmados.

Pedidos

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

Order Status After Payment: o pagamento foi capturado, e o valor e a moeda foram verificados. Padrão: Processando.

Awaiting KOMOJU Payment Status: o pagamento está autorizado: um comprovante de konbini ou de transferência bancária foi emitido, ou o pagamento aguarda a captura no painel da KOMOJU. Padrão: Pagamento pendente.

KOMOJU Payment On Hold Status: o valor ou a moeda pagos diferem do pedido, ou o pagamento chegou depois que o pedido foi cancelado. Uma nota explica o motivo. Padrão: Pagamento pendente, porque o OpenCart não tem o status Em espera.

Cancelled Payment Status: o pagamento de um pedido aguardando expirou ou foi cancelado, por exemplo quando o comprovante de konbini não foi pago a tempo. Padrão: Cancelado.

Failed Payment Status: o pagamento de um pedido aguardando falhou. Padrão: Falhou.

Refunded Status: definido depois que o pagamento é totalmente reembolsado, pela página do pedido ou pelo painel da KOMOJU. Padrão: Reembolsado.

Você pode criar seus próprios status, por exemplo Pagamento KOMOJU pendente ou Em espera, em System > Localisation > Order Statuses e selecioná-los aqui.

Avançado

Invoice Prefix: o prefixo dos números de pedido enviados à KOMOJU. O número na KOMOJU é o prefixo, o número do pedido do OpenCart e um pequeno sufixo aleatório, por exemplo OC-123-A1B2C3. Se você usa várias lojas com a mesma conta da KOMOJU, deixe o prefixo único para cada loja. Padrão: OC-.

Enable Logging: grava os eventos da KOMOJU e as chamadas à API em komoju_p_debug.log.php, na pasta de logs do OpenCart (storage/logs). O arquivo não pode ser aberto pela web. Chaves e dados de clientes não são registrados. Erros e alertas são sempre gravados. Padrão: desativado.

Log: mostra o tamanho e as últimas entradas do log. Clique em Clear log para limpá-lo.

Delete data on uninstall: quando ativado, ao desinstalar a extensão são removidas as configurações do gateway e o log. Os pedidos e as transações e reembolsos da KOMOJU são sempre mantidos, para que pedidos antigos possam ser confirmados e reembolsados depois de uma reinstalação. Padrão: desativado.

Importar / Exportar

Export: Download JSON salva as configurações em um arquivo JSON. Chaves secretas e tokens de webhook não são exportados.

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

Checkout

Na etapa Payment Method, o cliente escolhe o método de pagamento (por padrão, KOMOJU Payment). Na etapa Confirm Order, o cliente vê a sua descrição e a nota You will be redirected to the KOMOJU payment 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 cria uma sessão de pagamento da KOMOJU para o total do pedido na moeda do pedido e envia o cliente para a página de pagamento da KOMOJU. O e-mail, o nome, os endereços de cobrança e de entrega e os itens do pedido são transmitidos à KOMOJU. A página é exibida em japonês, inglês ou coreano, conforme o idioma do cliente (em inglês para os demais idiomas). Ali o cliente escolhe um método de pagamento. Os métodos oferecidos dependem da sua conta na KOMOJU e da moeda do pedido.

No OpenCart 4, o cliente escolhe o método de pagamento com o botão Choose no 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 de compra. Por padrão, o OpenCart 4 não pede um endereço de pagamento; nesse caso a extensão envia à KOMOJU o endereço de entrega como endereço de pagamento.

Depois de pagar, o cliente volta à sua loja. A extensão lê a sessão de pagamento na API da KOMOJU com a chave do modo do pagamento. O pedido só é marcado como pago depois que a KOMOJU confirma: pelo webhook assinado ou pela leitura da sessão quando o cliente retorna. 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 KOMOJU has been received. Se a KOMOJU não puder ser acessada naquele momento, ou se o pagamento estiver confirmado mas ainda não aplicado, aparece uma página Payment confirmation com We could not confirm the payment status with KOMOJU yet. If you completed the payment, your order will be updated automatically in a few minutes. e um botão Check again.

Nos pagamentos por konbini e transferência bancária, o cliente recebe um comprovante de pagamento. O pedido recebe Awaiting KOMOJU Payment Status, e a página de sucesso informa ao cliente que o pagamento está autorizado e deve ser concluído conforme as instruções da KOMOJU (por exemplo, em uma loja de conveniência ou por transferência bancária). O pedido passa para Order Status After Payment quando o cliente paga e a KOMOJU envia o webhook. Se o comprovante expirar, o pedido passa para Cancelled Payment Status.

Se o pagamento não foi concluído, o cliente volta ao checkout com a mensagem The payment was not completed. You can try again or choose another payment method. Se o pedido já estava cancelado, a mensagem é The KOMOJU payment was not completed and the order has been cancelled. O carrinho é mantido. No OpenCart 4, essas mensagens são exibidas acima da página de finalização de compra. Cada nova tentativa (o OpenCart 3 cria um novo pedido sempre que a etapa Confirm Order é exibida; o OpenCart 4 atualiza o pedido da finalização de compra e paga o mesmo pedido) verifica as sessões abertas da KOMOJU deste pedido e de outros pedidos do mesmo carrinho: a sessão aberta deste pedido com o total inalterado é reutilizada, as outras sessões abertas são canceladas na KOMOJU, e uma sessão que foi paga nesse meio-tempo confirma o seu pedido em vez de criar um novo pagamento. Uma alteração do carrinho, incluindo 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, nesse meio-tempo, o pedido foi fechado (por exemplo, o comprovante de konbini expirou, o pagamento falhou ou você cancelou o pedido), o cliente volta à finalização de compra com a mensagem Your previous order was cancelled or its payment failed. Please confirm the order again. Se o pedido já foi registrado e o carrinho agora tem outros produtos, a mensagem é Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again. Nos dois casos, o próximo clique em Confirm Order paga um novo pedido do carrinho.

Se a KOMOJU não puder iniciar o pagamento, o cliente permanece na etapa Confirm Order com uma mensagem curta acima do botão, por exemplo KOMOJU could not accept this payment: com o motivo, KOMOJU payments are temporarily unavailable. Please choose another payment method or contact us. ou Payment error: Could not connect to KOMOJU. Please try again in a moment. O motivo técnico é gravado no log.

O webhook também funciona enquanto a loja está em modo de manutenção: o OpenCart 3 deixa passar as requisições das extensões de pagamento, e no OpenCart 4 a extensão adiciona uma ação de inicialização (startup action) que deixa passar o webhook e o retorno do cliente.

A extensão não tem formulário de cartão no seu site, cartões salvos ou assinaturas. Ela não restringe os métodos de pagamento: eles são escolhidos na página da KOMOJU. Não há ação de captura manual: pagamentos autorizados para captura manual precisam ser capturados no painel da KOMOJU, e o pedido permanece em Awaiting KOMOJU Payment Status até lá.

Pedidos e reembolsos

Status de pedido

No status (missing order): o cliente foi enviado à KOMOJU e não pagou, ou a KOMOJU ainda não confirmou o pagamento. Em Sales > Orders, esses pedidos aparecem somente com o filtro Order Status definido como Missing Orders.

Order Status After Payment (default Processing): a KOMOJU confirmou o pagamento. Uma nota mostra o ID do pagamento na KOMOJU, o método de pagamento e como ele foi confirmado (webhook ou retorno).

Awaiting KOMOJU Payment Status (default Pending): um comprovante de konbini ou de transferência bancária foi emitido e aguarda pagamento, ou um pagamento aguarda captura no painel da KOMOJU.

KOMOJU Payment On Hold Status (default Pending): a KOMOJU informou um valor ou uma moeda diferentes do total do pedido, ou o pagamento foi capturado depois que o pedido havia sido cancelado. A nota explica. Verifique o pedido e atenda-o ou reembolse o pagamento.

Cancelled Payment Status (default Canceled): o comprovante de pagamento expirou ou o pagamento foi cancelado.

Failed Payment Status (default Failed): o pagamento de um pedido aguardando falhou.

Refunded Status (default Refunded): o pagamento foi totalmente reembolsado, pela página do pedido ou pelo painel da KOMOJU.

Se um segundo pagamento for capturado para um pedido que já está pago, ou para outro pedido de um carrinho que já está pago, o pedido não é alterado. Uma nota pede que você o reembolse no painel da KOMOJU se for um duplicado. Pedidos reembolsados nunca são reabertos.

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

Aba VibeFox KOMOJU Payment

Em Sales > Orders, abra um pedido pago com KOMOJU. Na parte inferior da página do pedido, ao lado de History e Additional, a aba VibeFox KOMOJU Payment mostra o ID do pagamento na KOMOJU (com link para o pagamento no painel da KOMOJU), um rótulo Test mode para pagamentos de teste, o método de pagamento, a sessão, o número do pedido na KOMOJU, o status, os valores Paid / refunded, o formulário de reembolso, o histórico de reembolsos (do OpenCart ou do painel da KOMOJU) e as KOMOJU notes do pedido. A aba é exibida para usuários que têm acesso à extensão.

Reembolsos

Na aba VibeFox KOMOJU Payment, informe o Amount (o valor ainda não reembolsado é preenchido), opcionalmente um Reason (optional), e clique em Refund via KOMOJU. Confirme a pergunta Refund this amount through KOMOJU? This cannot be undone. Reembolsos totais e parciais são suportados. Você precisa do direito de modificar a extensão (definido em System > Users > User Groups). Os reembolsos são limitados ao valor que a KOMOJU realmente cobrou, então, após uma diferença de valor, você pode reembolsar até o que o cliente pagou, não o total do pedido. O reembolso é enviado com a chave do modo em que o pagamento foi feito, então a chave secreta desse modo precisa estar configurada. A extensão primeiro verifica o pagamento na KOMOJU e recusa reembolsos acima do valor ainda reembolsável. Se a KOMOJU não puder reembolsar um pagamento automaticamente (alguns métodos, por exemplo konbini, precisam dos dados bancários do cliente), a mensagem de erro da KOMOJU é exibida e nada é registrado: trate esses reembolsos no painel da KOMOJU. Um reembolso só conta como feito quando a KOMOJU o confirma. Um reembolso bem-sucedido é adicionado ao histórico de reembolsos e às notas. Um reembolso total define o pedido para Refunded Status sem devolver produtos ao estoque, como uma alteração manual de status. Um reembolso parcial não altera o status. Reembolsos estão disponíveis depois que a KOMOJU captura o pagamento.

Para pagamentos que a KOMOJU converteu em outra moeda (por exemplo, konbini em JPY para um pedido em EUR), a partir do OpenCart só é possível um reembolso total. Faça os reembolsos parciais no painel da KOMOJU.

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

Reembolsos feitos no painel da KOMOJU chegam por webhook e são adicionados ao histórico de reembolsos com uma nota. Quando o pagamento inteiro é reembolsado, o pedido é definido para Refunded Status. Reembolsos parciais feitos no painel para pagamentos convertidos em outra moeda são apenas anotados no pedido: registre manualmente no OpenCart o valor correspondente.

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 KOMOJU Payment é o primeiro bloco em Extensions > Extensions > Payments > VibeFox KOMOJU 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-komoju 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 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 de alterar o endereço da loja, ou depois de liberar uma vaga de domínio na sua conta, clique em Check now. Se o servidor de licenças não puder ser acessado, a extensão continua funcionando com o último status conhecido.

Uma chave funciona em um domínio: o endereço da loja na configuração do OpenCart. Remover a chave da loja não libera a vaga de domínio. Libere-a na sua conta em vibefox.net.

Sem uma chave ativa, a KOMOJU não é exibida aos clientes no checkout. 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 esta prévia não está disponível: a loja não enxerga o login no 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, um lembrete aparece 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, 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 admin: uma vez por dia nos primeiros 14 dias após a chave ser informada, 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 KOMOJU não aparece no checkout: verifique se a licença está ativa, se Enable/Disable está ativado e se o modo atual tem uma chave secreta: Sandbox Secret Key no modo de teste, Live Secret Key no modo de produção. O cliente precisa pagar em uma moeda aceita pela KOMOJU. A página de configurações mostra um aviso quando algo está faltando. Verifique também se o endereço de pagamento está na Geo Zone selecionada e se o pedido atinge o Total definido nas configurações.

O pagamento foi feito, mas o pedido continua sem status: o webhook não está funcionando. No painel da KOMOJU, verifique se o webhook existe para o modo que você usa, se a URL dele é exatamente a mostrada na seção Webhook URL e se os eventos estão selecionados. Verifique se o token secreto está no campo correspondente (Live Webhook Secret Token ou Sandbox Webhook Secret Token) e consulte o campo Log na página da extensão. Pagamentos com cartão também são confirmados quando o cliente volta à sua loja, mas pagamentos por konbini e transferência bancária são confirmados somente pelo webhook.

O webhook responde Failed to verify KOMOJU webhook signature.: o token secreto está faltando ou pertence a outro webhook. A KOMOJU tenta a notificação novamente.

O webhook responde Mode mismatch, ignored.: o webhook foi assinado com o token secreto do outro modo, diferente do modo em que o pagamento foi feito. Use webhooks e tokens separados para produção e teste, e confira se não estão trocados.

O webhook responde Order not found.: o pagamento não pertence a um pedido desta loja, por exemplo porque foi feito por outra loja com a mesma conta da KOMOJU. O evento é ignorado.

O webhook responde Order is busy, retry later. ou Temporary error, retry later.: o pedido estava sendo atualizado por outra requisição, ou o pagamento não pôde ser processado naquele momento. A KOMOJU tenta a notificação novamente. O motivo está no log.

A URL do webhook mostra um erro no navegador: isso é normal. A URL aceita somente requisições assinadas pela KOMOJU.

O pedido está em status de espera ou retido: leia as KOMOJU notes na aba do pedido. Há um comprovante aguardando pagamento, um pagamento aguardando captura no painel da KOMOJU, o valor ou a moeda não correspondiam, ou o pagamento chegou depois que o pedido foi cancelado.

Não há formulário de reembolso na aba: a aba informa o motivo: a KOMOJU ainda não capturou o pagamento, ele está totalmente reembolsado, seu grupo de usuários não tem o direito de modificar a extensão, ou a chave secreta do modo do pagamento não está configurada.

O reembolso falha: leia a mensagem. A chave secreta do modo em que o pagamento foi feito pode estar faltando, o pagamento pode não ser reembolsável automaticamente (reembolse-o no painel da KOMOJU), a KOMOJU pode não reconhecer o pagamento com a chave configurada, ou apenas um reembolso total é possível para um pagamento convertido.

Para desenvolvedores: a extensão dispara os eventos do OpenCart komoju_p_supported_currencies (para alterar a lista de moedas) e komoju_p_session_params (para alterar a sessão de pagamento, por exemplo os métodos de pagamento).

Desinstalação

Acesse Extensions > Extensions, escolha o tipo Payments e clique em Uninstall (o botão vermelho −) ao lado de VibeFox KOMOJU 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 a sua ação de inicialização (startup action), que deixa passar o webhook e o retorno do cliente no modo de manutenção). Se Delete data on uninstall estiver ativado, as demais configurações do gateway (título, descrição, chaves, tokens de webhook, modo de teste, prefixo da fatura, registro) e o log são removidos. Se estiver desativado, são mantidos para uma reinstalação posterior. As transações e reembolsos da KOMOJU são sempre mantidos, para que pedidos antigos possam ser confirmados e reembolsados depois de 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 acesse Extensions > Installer e clique em Uninstall (o botão laranja −) ao lado de VibeFox KOMOJU Payment na lista de extensões instaladas, depois em Delete (o botão vermelho com a lixeira) para remover o pacote enviado.

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