VibeFox MakeCommerce for WooCommerce — Ajuda
Requisitos
WordPress: 6.0 ou superior.
WooCommerce: 7.0 ou superior, instalado e ativo. Sem o WooCommerce, o plugin se recusa a ser ativado.
PHP: 8.0 ou superior.
Acesso à internet para o seu site: a MakeCommerce envia notificações de pagamento para a sua loja, portanto o site deve estar acessível pela internet (HTTPS recomendado). Um firewall, modo de manutenção ou autenticação básica podem bloqueá-las.
Conta MakeCommerce: você precisa do Shop ID e da Secret key obtidos no MakeCommerce Merchant Portal (Settings > API). Os ambientes de teste e de produção possuem contas e chaves separadas. Quais métodos de pagamento e moedas estão disponíveis é definido pelo seu contrato com a MakeCommerce (os links bancários são em EUR). Moedas com três casas decimais, como KWD ou BHD, não são oferecidas.
Chave de licença VibeFox: adquirida em vibefox.net. Uma chave funciona em um domínio.
Instalação
1. No WordPress, acesse Plugins > Add New > Upload Plugin, escolha o arquivo ZIP do plugin e clique em Install Now. Você também pode enviar a pasta wcp_makecommerce_payment para /wp-content/plugins/ via FTP.
2. Clique em Activate.
3. Abra as configurações: WooCommerce > Settings > Payments > MakeCommerce > Manage, ou clique em Settings sob o nome do plugin na página de Plugins.
4. Digite a sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.
5. Insira o Shop ID e a Secret key do ambiente de teste e, para pagamentos reais, as chaves de produção (consulte Configuração). Nada precisa ser configurado no Merchant Portal.
6. Ative Enable/Disable. Teste um pagamento com o Test mode ativado e, em seguida, desmarque-o para aceitar pagamentos reais.
Configuração
Todas as configurações ficam em uma única página: WooCommerce > Settings > Payments > MakeCommerce. Acima dos campos, a página exibe Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged. enquanto o modo de teste estiver ativo. Ela avisa você quando o método estiver ativado, mas o Shop ID ou a Secret key do ambiente atual estiverem vazios, e quando a moeda da loja não puder ser cobrada pela MakeCommerce. Em ambos os casos, o método fica oculto na finalização de compra. Na lista de métodos de pagamento, o MakeCommerce é marcado como necessitando de configuração até que o ambiente atual tenha suas chaves. Espaços são removidos das chaves ao salvar.
General
Enable/Disable: Enable MakeCommerce payments ativa ou desativa o método de pagamento. Padrão: desativado.
Title: o nome do método de pagamento que os clientes veem na finalização de compra. Padrão: Bank link or card (MakeCommerce).
Description: o texto exibido sob o método de pagamento na finalização de compra. Padrão: Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.
MakeCommerce account
O Shop ID e a Secret key estão no MakeCommerce Merchant Portal em Settings > API. O portal de testes e o portal de produção têm contas e chaves separadas. A seção traz links para ambos os portais e para a página de cadastro da MakeCommerce.
Test mode: Use the MakeCommerce test environment (no real money is charged). Novos pagamentos são criados no ambiente selecionado com suas respectivas chaves. Cada pedido se lembra do ambiente em que foi pago: verificações de status e reembolsos sempre são direcionados a ele. A linha TEST MODE — MakeCommerce test environment, no real money is charged. é exibida na finalização de compra. Padrão: ativado.
Test Shop ID: o Shop ID da sua conta de testes, no formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Test Secret key: a Secret key da sua conta de testes.
Live Shop ID: o Shop ID da sua conta de produção.
Live Secret key: a Secret key da sua conta de produção.
Payment notifications
Nada precisa ser configurado no Merchant Portal. Cada transação transporta suas próprias URLs de retorno, cancelamento e notificação, com base no endereço mostrado nesta seção (parecido com https://your-site/wc-api/wc_mkc_payment/) com o número do pedido e a chave do pedido adicionados. A MakeCommerce envia uma mensagem assinada para a URL de notificação (de servidor para servidor) e, por meio do navegador do cliente, para a URL de retorno ou cancelamento. A assinatura é conferida com a Secret key do ambiente em que a transação foi criada. Mensagens sem assinatura válida são rejeitadas.
O plugin processa estes status de transação da MakeCommerce:
O pagamento também é confirmado quando o cliente retorna à loja. Se o cliente retornar sem uma mensagem assinada, o plugin consulta o status na API da MakeCommerce.
Advanced
Debug log: Log API calls and payment notifications grava os detalhes em WooCommerce > Status > Logs, origem wcp_makecommerce_payment. Erros são sempre gravados. Chaves e dados dos clientes nunca são gravados no log. Padrão: desativado.
Delete data: Delete the gateway settings and logs when the plugin is deleted. Os pedidos e suas notas de pagamento são sempre mantidos. A desativação do plugin nunca exclui nada. Padrão: desativado.
Finalização de compra
O cliente escolhe o método de pagamento (por padrão Bank link or card (MakeCommerce)) e faz o pedido. O plugin cria uma transação da MakeCommerce para o total do pedido na moeda do pedido e encaminha o cliente para a página de pagamento da MakeCommerce. Lá, o cliente escolhe um link bancário ou um cartão. O e-mail e o país de cobrança são repassados à MakeCommerce, e a página abre no idioma da loja quando a MakeCommerce tiver suporte (estoniano, inglês, letão, lituano, finlandês, russo, alemão, polonês); caso contrário, em inglês.
Após pagar, o cliente retorna à página de pedido recebido da sua loja. O pedido só é marcado como pago depois que a MakeCommerce confirma: por meio da notificação assinada ou pelo retorno assinado do cliente, com uma verificação da transação através da API da MakeCommerce.
Se o cliente cancelar na página da MakeCommerce ou o pagamento expirar, o cliente retorna à finalização de compra (ou à página Pay for order) com uma mensagem, por exemplo The payment was cancelled. You can try again or choose another payment method. ou The payment session expired. Please try again. Se o pagamento ainda não puder ser confirmado, a mensagem será We could not confirm your payment yet. If you completed it, your order will be updated automatically; otherwise please try again. O cliente pode pagar novamente. Um link de pagamento anterior do mesmo pedido ainda funciona, e o pedido não pode ser pago duas vezes.
Se a MakeCommerce não conseguir iniciar o pagamento, o cliente verá MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. ou MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. O motivo técnico é incluído nas notas do pedido e no log.
O método de pagamento funciona na finalização de compra clássica, no bloco de Finalização de compra e na página Pay for order. Ele é compatível com o armazenamento de pedidos de alto desempenho (HPOS) do WooCommerce.
O banco ou cartão é escolhido na página da MakeCommerce, não na sua finalização de compra. O plugin não possui cartões salvos, pagamentos recorrentes ou WooCommerce Subscriptions e não inclui envios MakeCommerce (estações de encomendas, etiquetas).
Pedidos e reembolsos
Status dos pedidos
Pending payment: o cliente foi enviado para a MakeCommerce e ainda não realizou o pagamento, ou a MakeCommerce ainda não confirmou o pagamento. A nota do pedido mostra a transação da MakeCommerce, o valor e o ambiente.
Processing: o pagamento foi confirmado. Pedidos que contêm apenas produtos virtuais baixáveis mudam para Concluído, o comportamento padrão do WooCommerce. A nota do pedido mostra o valor, a transação, o ambiente e como foi verificado (API da MakeCommerce ou notificação assinada). O ID da transação é o ID da transação da MakeCommerce.
On hold: o valor pago ou a moeda diferiam do pedido, o valor estava ausente, o status da transação na MakeCommerce ainda não era definitivo ou o pagamento chegou para um pedido cancelado. A nota do pedido traz a explicação. Essa transação nunca pagará o pedido mais tarde. Verifique a transação no Merchant Portal e conclua ou reembolse o pedido manualmente.
Failed: o pagamento mais recente do pedido foi cancelado, expirou ou falhou. O cliente pode tentar pagar novamente.
Se um segundo pagamento chegar para um pedido que já está pago, o pedido não é alterado novamente. Uma nota solicita que você reembolse a cobrança duplicada no MakeCommerce Merchant Portal.
Check MakeCommerce payment status
Na tela do pedido, escolha Check MakeCommerce payment status nas ações do pedido. O plugin consulta a API da MakeCommerce sobre o status das transações do pedido (a mais recente primeiro), aplica-o e adiciona uma nota com o resultado. Use essa opção quando um pedido permanecer em Aguardando pagamento embora o cliente tenha pago.
Reembolsos
Abra o pedido, clique em Refund, insira o valor e clique em Refund via Bank link or card (MakeCommerce) (o botão exibe o seu Title). Há suporte para reembolsos totais e parciais. O reembolso é enviado ao ambiente em que o pedido foi pago (teste ou produção), portanto as chaves desse ambiente precisam estar configuradas. Se a MakeCommerce não aceitar o reembolso, o WooCommerce exibe o erro, uma nota é adicionada e nenhum reembolso é registrado. Se a MakeCommerce ainda estiver processando o pagamento, a mensagem será MakeCommerce is still processing this payment — try the refund again later. Um reembolso bem-sucedido é adicionado às notas do pedido com o ID de reembolso da MakeCommerce.
Reembolsos efetuados no Merchant Portal chegam com o status da transação e são adicionados às notas do pedido. Eles não são registrados automaticamente como reembolsos do WooCommerce.
Chave de licença
O plugin funciona com uma chave de licença VibeFox obtida em vibefox.net. O bloco de licença fica no topo de WooCommerce > Settings > Payments > MakeCommerce. Cole a chave em License key e clique em Activate. O bloco mostra o status, por exemplo a data até a qual a licença está ativa e o seu domínio. Use Check now para verificar o status novamente, Change key para inserir outra chave e Remove key para removê-la deste site. O link Manage licenses and domains in your account abre a sua conta no vibefox.net.
Uma chave funciona em um domínio. Remover a chave de um site não libera a vaga do seu domínio. Libere a vaga na sua conta no vibefox.net.
Sem uma chave ativa, a MakeCommerce não é exibida aos clientes na finalização de compra. Se um pagamento for iniciado mesmo assim, o cliente verá This payment method is not available. Please choose another one. Gerentes da loja conectados ainda veem o método de pagamento, marcado com (unlicensed — visible to admins only), para que você possa configurar e testar o plugin antes de comprar uma chave. Um lembrete é exibido na página de Plugins e nas páginas do WooCommerce. Pedidos existentes não são afetados: pagamentos já iniciados continuam sendo confirmados e reembolsos funcionam normalmente.
Quando uma licença expira, o plugin continua funcionando, mas atualizações e suporte necessitam de renovação. O status é verificado novamente de forma automática em segundo plano.
Solução de problemas
MakeCommerce não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ligado e se o ambiente atual tem suas chaves: Test Shop ID e Test Secret key no modo de teste, Live Shop ID e Live Secret key no modo de produção. Verifique se a moeda da loja (ou a moeda do pedido na página Pay for order) tem no máximo duas casas decimais. A página de configurações exibe um aviso para cada um desses problemas.
O pagamento foi efetuado, mas o pedido continua em Aguardando pagamento: as notificações não conseguiram chegar ao site, por exemplo devido a um firewall, modo de manutenção ou autenticação básica. Abra o pedido e execute a ação de pedido Check MakeCommerce payment status. Verifique se as chaves do ambiente no qual o pagamento foi efetuado estão configuradas: a notificação é conferida com a Secret key desse ambiente, e sem ela a MakeCommerce recebe um erro e tenta novamente.
O pedido está Em espera com uma nota da MakeCommerce: o pagamento não correspondia ao pedido (valor, moeda, status) ou chegou para um pedido cancelado. Verifique a transação no Merchant Portal e conclua ou reembolse o pedido manualmente.
Notificações são rejeitadas: uma mensagem com assinatura incorreta, referente a outro pedido, outra loja ou uma transação que não foi criada para o pedido é rejeitada e o pedido não é alterado. Verifique se o Shop ID e a Secret key pertencem à mesma conta e ao mesmo ambiente da MakeCommerce.
O cliente vê um erro ao fazer o pedido: abra as notas do pedido ou ative o Debug log e verifique em WooCommerce > Status > Logs, origem wcp_makecommerce_payment. Uma moeda que a MakeCommerce não puder cobrar gera o aviso MakeCommerce cannot process payments in acompanhado do código da moeda.
O reembolso falha com uma mensagem sobre o ambiente: o pedido foi pago no ambiente de teste ou de produção, e as chaves desse ambiente não estão configuradas. Insira-as e tente novamente.
O reembolso falha com No MakeCommerce transaction ID found for this order: o pedido não possui uma transação da MakeCommerce. Faça o reembolso diretamente no Merchant Portal.
O bloco de licença mostra um erro: siga a mensagem apresentada no bloco. Por exemplo, se a chave já estiver em uso em outro domínio, libere uma vaga na sua conta no vibefox.net e clique em Check now. Se o endereço do site mudou, clique em Check now para ativar a chave no novo domínio. Se o servidor de licenças não puder ser contatado, o plugin continuará funcionando no último status conhecido.
Desinstalação
A desativação do plugin mantém todos os dados. Para removê-lo, desative e exclua o plugin na página Plugins. A chave de licença e o status da licença deste plugin são sempre excluídos. As configurações do gateway e os logs só serão excluídos se Delete data estava ativado. Caso contrário, permanecerão para uma reinstalação futura. Pedidos existentes mantêm suas notas de pagamento e IDs de transação.
MakeCommerce é uma marca comercial do seu respectivo proprietário. Este plugin não é afiliado nem endossado pela MakeCommerce.