VibeFox GMO for WooCommerce — Ajuda
Requisitos
WordPress: 6.0 ou superior.
WooCommerce: 8.0 ou superior, instalado e ativo. Sem ele, o plugin não permite a ativação.
PHP: 8.0 ou superior.
Moeda da loja: iene japonês (JPY). Com outra moeda da loja, o método de pagamento fica oculto na finalização de compra. Na página Pay for order, vale a moeda do pedido.
Conta GMO Payment Gateway: um contrato de comerciante com o GMO-PG com Link Type Plus. Você precisa do Shop ID, da Shop password e do Config ID do Link Type Plus (設定ID) do ambiente de teste e/ou produção, e da notificação do resultado (結果通知) ativada no console da loja GMO-PG (veja Configuração). O Site ID e a Site password não são usados.
Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um domínio.
Instalação
1. No WordPress, acesse Plugins > Add New > Upload Plugin, selecione o arquivo ZIP do plugin e clique em Install Now. Você também pode enviar a pasta wcp_gmo_payment para /wp-content/plugins/ por FTP.
2. Clique em Activate.
3. Abra as configurações: WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card > Manage, ou clique em Settings abaixo do nome do plugin na página de plugins.
4. Digite sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.
5. Digite o Shop ID, a Shop password e o Config ID do ambiente de teste e/ou produção e escolha Environment.
6. No console da loja GMO-PG, ative 結果通知 (notificação do resultado) e defina a URL de notificação mostrada nas configurações (veja Configuração).
7. Ative Enable/Disable. Faça um pagamento de teste no ambiente de teste e depois mude Environment para produção.
Configuração
Todas as configurações ficam em uma página: WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card. O título da página exibe um selo TEST ou PRODUCTION para o ambiente atual. Acima dos campos, a página avisa quando a moeda da loja não é JPY ou quando faltam Shop ID, Shop password ou Config ID do ambiente atual. Nos dois casos, o método de pagamento fica oculto na finalização de compra. Na lista de métodos de pagamento, o gateway aparece como precisando de configuração até que as credenciais do ambiente atual sejam preenchidas. Espaços no início e no fim das credenciais são removidos ao salvar.
Enable/Disable: Enable GMO Payment Gateway — Credit Card ativa ou desativa o método de pagamento. Padrão: desativado.
Title: o nome do método de pagamento exibido na finalização de compra. Padrão: Credit card.
Description: o texto exibido abaixo do método de pagamento na finalização de compra. Padrão: You will be redirected to the secure GMO Payment Gateway page to pay by credit card.
Conta GMO-PG
O Shop ID e a Shop password ficam no console da loja GMO-PG em Shop management > Shop information, e o Config ID em Link Type Plus > Settings (設定ID). Os ambientes de teste e produção têm credenciais diferentes.
Environment: qual ambiente GMO-PG recebe os pagamentos.
Credenciais de produção (p01.mul-pay.jp)
Production Shop ID: o Shop ID do ambiente de produção.
Production Shop password: a Shop password do ambiente de produção.
Production Config ID: o ID de configuração do Link Type Plus (設定ID) registrado no console GMO-PG.
Credenciais de teste (pt01.mul-pay.jp)
Test Shop ID: o Shop ID do ambiente de teste.
Test Shop password: a Shop password do ambiente de teste.
Test Config ID: o ID de configuração do Link Type Plus (設定ID) do ambiente de teste.
Pagamento
Capture: quando o cartão é cobrado.
Order status after payment: o status de um pedido pago. Ele é definido imediatamente, com uma única mudança de status e um único e-mail ao cliente.
Notificações de pagamento (結果通知)
A notificação do resultado informa à sua loja que um pagamento foi realizado. Ela é obrigatória. No console da loja GMO-PG, ative 結果通知 (notificação do resultado) e defina a URL de notificação exibida nesta seção das configurações. Ela se parece com https://your-site/wc-api/gmo_pg_webhook/. Copie a URL exatamente como aparece nas configurações.
As notificações GMO-PG não são assinadas, por isso o plugin nunca confia no conteúdo delas. A notificação deve vir de um dos Shop IDs configurados e se referir a um pagamento criado por esta loja, no ambiente em que o pedido foi pago. O plugin então solicita a transação ao GMO-PG (SearchTrade) com sua Shop password e altera o pedido somente com base nessa resposta. Uma notificação que não corresponda a uma transação real não altera nada. O recebimento de transações não criadas pela loja, como as feitas no console GMO-PG, é confirmado, mas elas são ignoradas. Quando o plugin não consegue verificar uma notificação, responde de forma que o GMO-PG a envie novamente (o GMO-PG faz até 5 novas tentativas).
Sem a notificação, um pedido só é confirmado quando o cliente volta à loja depois de pagar.
Avançado
Debug log: Log API requests and notifications os grava em WooCommerce > Status > Logs, origem wcp_gmo_payment. Os erros são sempre registrados. Senhas e dados dos clientes são mascarados. Padrão: desativado.
Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted. A desativação nunca exclui nada. Os dados dos pedidos (IDs de transação) são sempre mantidos. Padrão: desativado.
Finalização de compra
O cliente escolhe o método de pagamento (por padrão Credit card) e faz o pedido. O plugin cria um pagamento GMO-PG Link Type Plus para o total do pedido, arredondado para ienes inteiros, e direciona o cliente à página de pagamento GMO-PG. Lá o cliente paga com cartão de crédito. O GMO-PG gerencia o 3-D Secure 2.0 e recebe o e-mail de cobrança do cliente para o 3-D Secure. A página de pagamento abre em japonês, chinês ou inglês, conforme o idioma do seu site. O pagamento aparece no GMO-PG com WC- e o número do pedido. Nenhum outro dado do cliente é enviado.
Após pagar, o cliente volta à sua loja. O resultado assinado é verificado com sua Shop password, e o pedido só é marcado como pago após a confirmação do GMO-PG: por uma solicitação SearchTrade do servidor quando o cliente retorna ou pela notificação do resultado. Os dois caminhos usam a mesma lógica, então o pedido nunca é processado duas vezes. Se o pagamento ainda não estiver confirmado, a página de pedido recebido mostra Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed.
Se o cartão for recusado ou o pagamento falhar na página GMO-PG, o pedido passa para Malsucedido e o cliente é levado à página Pay for order com a mensagem The card payment was declined or could not be completed. Please try again or use another card. Se o cliente sair da página GMO-PG sem pagar, a mesma página mostra The payment was not completed. You can try again or choose another payment method. Cada nova tentativa cancela o link de pagamento anterior não pago. Se o link anterior já tiver sido pago nesse intervalo, esse pagamento é aplicado e nenhum novo link é criado.
Pedidos com totais de 1 a 9.999.999 JPY podem ser pagos. Valores maiores ocultam o método de pagamento. Se não for possível iniciar o pagamento, o cliente vê uma mensagem curta, por exemplo Card payment could not be started. Please try again or choose another payment method., e o motivo é adicionado às notas do pedido.
O método de pagamento funciona na finalização de compra clássica, nos blocos de Carrinho e Finalização de compra e na página Pay for order. No bloco de Finalização de compra, exibe o ícone de cartão e a descrição. No ambiente de teste, tanto a finalização de compra clássica quanto o bloco de Finalização de compra exibem o selo Test mode — no real charge. É compatível com o armazenamento de pedidos de alto desempenho do WooCommerce (HPOS).
O plugin aceita pagamentos com cartão de crédito apenas em JPY, sempre na página GMO-PG. Não oferece outros métodos de pagamento GMO-PG, várias moedas, cartões salvos ou cadastro de membros GMO-PG, assinaturas ou cobranças recorrentes, nem formulário de cartão no seu site.
Pedidos e reembolsos
Status dos pedidos
Pending payment: o cliente foi direcionado ao GMO-PG e ainda não pagou, ou o GMO-PG ainda não confirmou o pagamento.
Processing or Completed: o pagamento foi confirmado. O status segue Order status after payment. A nota do pedido mostra o valor, o status GMO-PG, a transação e como ela foi confirmada (notificação ou retorno). O ID da transação é o TranID do GMO-PG.
On hold (authorized): com Authorize only (仮売上), o valor foi autorizado. Capture-o com a ação do pedido Capture payment (GMO-PG) ou no console GMO-PG antes que a autorização expire. Após a captura, o pedido passa para Processando ou Concluído. Se a autorização for cancelada no GMO-PG, o pedido é cancelado.
On hold after payment: o GMO-PG informou um valor diferente do total do pedido, ou o pagamento chegou após o cancelamento do pedido. A nota do pedido explica a situação. Verifique o pedido e atenda-o ou reembolse o pagamento.
Failed: o cartão foi recusado ou o pagamento não foi concluído na página GMO-PG.
Se um segundo pagamento chegar para um pedido já pago ou encerrado, o pedido não é alterado. Uma nota pede que você reembolse o pagamento duplicado no console GMO-PG.
Captura
A ação do pedido Capture payment (GMO-PG) aparece nos pedidos Aguardando que foram apenas autorizados. Ela cobra o valor autorizado. Se a transação não estiver mais autorizada, por exemplo porque já foi capturada no console GMO-PG, a ação adiciona uma nota com o status atual e o segue.
Reembolsos
Abra o pedido, clique em Refund, digite o valor e clique em Refund via Credit card (o botão exibe seu Title). São aceitos reembolsos totais e parciais em ienes inteiros. Reembolsar todo o valor restante cancela a transação GMO-PG, e o GMO-PG decide se é uma anulação ou uma devolução. Um reembolso parcial reduz o valor da transação e a operadora do cartão autoriza o novo valor. O reembolso é enviado ao ambiente em que o pedido foi pago, então o Shop ID e a Shop password desse ambiente precisam estar configurados. Se o GMO-PG não aceitar o reembolso, o WooCommerce mostra o erro e nenhum reembolso é registrado. Um reembolso bem-sucedido é adicionado às notas do pedido.
Reembolsos e cancelamentos feitos no console GMO-PG chegam pela notificação do resultado e são adicionados às notas do pedido. Eles não são registrados automaticamente como reembolsos do WooCommerce. Se necessário, crie um reembolso manual no WooCommerce sem o botão GMO-PG.
Chave de licença
O plugin funciona com uma chave de licença VibeFox de vibefox.net. O bloco de licença fica no topo de WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card. Cole a chave em License key e clique em Activate. O bloco mostra o status, como a data até quando a licença fica ativa e seu domínio. Use Check now para verificar o status novamente, Change key para digitar outra chave e Remove key para removê-la deste site. O link Manage licenses and domains in your account abre sua conta vibefox.net.
Uma chave funciona em um domínio. Remover a chave de um site não libera a vaga do domínio. Libere a vaga na sua conta vibefox.net.
Sem uma chave ativa, o método de pagamento não é mostrado 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. Os gerentes de loja conectados continuam vendo o método de pagamento, marcado como (unlicensed — visible to admins only), para que você possa configurar e testar o plugin antes de comprar uma chave. Um lembrete aparece na página de plugins e nas páginas do WooCommerce. Os pedidos existentes não são afetados: pagamentos já iniciados continuam sendo confirmados, e reembolsos e capturas funcionam.
Quando uma licença expira, o plugin continua funcionando, mas atualizações e suporte exigem renovação. O status é verificado novamente de forma automática em segundo plano.
Solução de problemas
O cartão de crédito não aparece na finalização de compra: verifique se a licença está ativa, Enable/Disable está ativado, a moeda da loja é JPY e o ambiente atual tem Shop ID, Shop password e Config ID. Pedidos acima de 9.999.999 JPY não podem ser pagos com cartão. A página de configurações mostra um aviso quando a moeda ou as credenciais estão incorretas.
O pagamento foi concluído, mas o pedido continua Pending payment: a notificação do resultado não está funcionando. No console da loja GMO-PG do ambiente usado, verifique se 結果通知 está ativado e se a URL é exatamente a mostrada nas configurações. Verifique se o Shop ID e a Shop password desse ambiente estão preenchidos, pois o plugin os usa para verificar cada notificação. Ative Debug log e consulte WooCommerce > Status > Logs, origem wcp_gmo_payment. O pedido também é confirmado quando o cliente volta à loja após pagar.
O log mostra Notification rejected: unknown ShopID: a notificação veio de uma loja cujo Shop ID não está nas configurações. Digite o Shop ID desse ambiente.
O log mostra Notification ignored ... is not a payment of this store: a transação não foi criada por esta loja, por exemplo foi feita no console GMO-PG. Não é necessário fazer nada.
O log indica que o pedido foi pago em outro ambiente: pagamentos de teste e produção são mantidos separados. Uma notificação de teste nunca confirma um pedido de produção e vice-versa.
O cliente vê um erro ao fazer o pedido: abra as notas do pedido ou ative Debug log. A nota mostra o código de erro GMO-PG (ErrCode, ErrInfo). Geralmente a causa é um Shop ID, uma Shop password ou um Config ID incorreto. GMO Payment Gateway accepts payments in Japanese Yen (JPY) only. significa que o pedido não está em JPY.
O pedido fica On hold após o pagamento: leia a nota do pedido. O pedido foi apenas autorizado e aguarda captura, o valor pago era diferente do total ou o pagamento chegou após o cancelamento do pedido.
O reembolso falha: leia a mensagem. O pedido pode ter sido pago no outro ambiente, cujo Shop ID e senha não estão configurados, a transação pode já estar cancelada no GMO-PG ou o valor pode exceder o saldo restante da transação.
O bloco de licença mostra um erro: siga a mensagem do bloco. Por exemplo, se a chave já estiver sendo usada em outro domínio, libere uma vaga na sua conta vibefox.net e clique em Check now. Se o endereço do site mudou, clique em Check now para ativar a chave para o novo domínio. Se não for possível acessar o servidor de licenças, o plugin continua funcionando com o último status conhecido.
Desinstalação
Desativar o plugin mantém todos os dados. Para removê-lo, desative e exclua o plugin na página Plugins. A chave e o status de licença deste plugin são sempre removidos. As configurações do gateway e os logs só são removidos se Delete data on uninstall estava ativado. Caso contrário, permanecem para uma reinstalação futura. Os dados GMO-PG armazenados nos pedidos são o histórico de pagamentos e sempre são mantidos. Os pedidos existentes mantêm as notas de pagamento e os IDs de transação.
GMO Payment Gateway é uma marca comercial do respectivo proprietário. Este plugin não é afiliado nem endossado pelo GMO Payment Gateway.