VibeFox Autopay for WooCommerce — Ajuda
Requisitos
WordPress: 6.0 ou superior.
WooCommerce: 8.0 ou superior, instalado e ativo.
PHP: 8.0 ou superior.
Serviço Autopay: você precisa do Service ID e da Shared key (chave de hash) do seu serviço Autopay. Eles são exibidos no portal de comerciante da Autopay: portal.autopay.eu para produção e testportal.autopay.eu para teste. Os serviços de teste têm Service ID e Shared key próprios; peça à Autopay para abrir um. A função hash do serviço precisa ser SHA-256.
Moeda: a moeda da loja precisa ser PLN, EUR, GBP, USD ou CZK e ser aceita pelo seu serviço Autopay.
Loja acessível: a Autopay precisa conseguir enviar notificações para a sua loja, então ela deve estar acessível pela internet, sem modo de manutenção, sem autenticação básica e sem firewall que bloqueie requisições POST.
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, escolha o arquivo ZIP do plugin e clique em Install Now. Você também pode enviar a pasta wcp_autopay_payment para /wp-content/plugins/ por FTP.
2. Clique em Activate.
3. Abra as configurações: WooCommerce > Settings > Payments > Autopay > Manage, ou clique em Settings abaixo do nome do plugin na página Plugins.
4. Insira a sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.
5. Insira o Service ID e a Shared key (teste e produção) e escolha as moedas do seu serviço.
6. No portal da Autopay, defina a URL de ITN, a URL de retorno e a função hash SHA-256 do seu serviço (veja Configuração).
7. Ative Enable/Disable. Faça um pedido de teste no modo de teste e, depois, desmarque Test mode para pagamentos reais.
Configuração
Todas as configurações estão em uma única página: WooCommerce > Settings > Payments > Autopay. Acima dos campos, a página avisa quando o Service ID ou a Shared key do ambiente selecionado está vazio, e quando a moeda da loja não está selecionada em Currencies. Nos dois casos, o método de pagamento fica oculto na finalização de compra. Na lista de métodos de pagamento, a Autopay aparece como necessitando de configuração até que o ambiente selecionado tenha credenciais.
Geral
Enable/Disable: Enable Autopay payment gateway ativa ou desativa o método de pagamento. Padrão: desativado.
Title: o nome do método de pagamento que o cliente vê na finalização de compra. Padrão: Autopay.
Description: o texto exibido abaixo do método de pagamento na finalização de compra. Padrão: Pay online by bank transfer, BLIK or card. You will be redirected to the secure Autopay payment page.
Serviço Autopay
O Service ID e a Shared key são exibidos no portal de comerciante da Autopay (portal.autopay.eu ou testportal.autopay.eu).
Test mode: Use the Autopay test environment (testpay.autopay.eu) and the test credentials below. Padrão: ativado. Desative para aceitar pagamentos reais em pay.autopay.eu com as credenciais de produção.
Service ID (production): o identificador numérico do serviço no portal.autopay.eu.
Shared key (production): a chave de hash do serviço de produção. Mantenha-a em sigilo.
Service ID (test): o identificador numérico do serviço no testportal.autopay.eu.
Shared key (test): a chave de hash do serviço de teste.
Currencies: as moedas que o seu serviço Autopay aceita: PLN, EUR, GBP, USD, CZK. A Autopay normalmente abre um serviço separado para cada moeda. O método de pagamento só é oferecido quando a moeda do pedido está selecionada aqui. Padrão: PLN.
Notificações de pagamento (ITN) e endereço de retorno
Insira estes endereços no portal da Autopay para o seu serviço, em produção e em teste. Os endereços exatos são exibidos nesta seção das configurações.
Sem a URL de ITN, os pedidos nunca são marcados como pagos. Cada ITN é verificada com o hash SHA-256 feito com a Shared key do serviço correspondente. Notificações sem hash válido ou com Service ID desconhecido são rejeitadas. Uma notificação só é aplicada a um pedido se o pagamento desse pedido tiver sido iniciado com o mesmo serviço Autopay. Notificações de pagamentos iniciados antes de você alternar o Test mode continuam sendo verificadas com a chave correta.
O plugin trata estes status de pagamento na ITN:
Avançado
Logging: Log payment events em WooCommerce > Status > Logs, origem wcp_autopay_payment. Chaves e dados do cliente nunca são registrados. Padrão: desativado.
Finalização de compra
O cliente escolhe o método de pagamento (por padrão, Autopay) e faz o pedido. A página seguinte mostra Thank you for your order. You are being redirected to Autopay to complete the payment. e envia o cliente à página de pagamento da Autopay. Se o cliente voltar com o botão de voltar do navegador, a página mostra o botão Pay with Autopay em vez de redirecionar de novo.
O plugin envia o total do pedido na moeda do pedido, o número do pedido como descrição (Order e o número) e o e-mail de faturamento do cliente. Na página da Autopay, o cliente escolhe o método de pagamento e paga.
Depois de pagar, o cliente volta à página de pedido recebido. O endereço de retorno é assinado, mas nunca altera o status do pedido. O pedido só é marcado como pago depois que a Autopay confirma com uma ITN assinada e o valor e a moeda coincidem com o pedido.
Se o pagamento falhar, o pedido passa a Falhou, e o cliente pode pagar novamente a partir do pedido, pelo link Pay. Se o pagamento não puder ser iniciado, o cliente vê uma mensagem curta, por exemplo Autopay payments are not configured. Please choose another payment method or contact the store. ou a informação de que a Autopay não aceita pagamentos nesta moeda.
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. É compatível com o armazenamento de pedidos de alto desempenho do WooCommerce (HPOS).
O plugin não faz reembolsos pelo WooCommerce, não tem assinaturas nem pagamentos recorrentes, não salva cartões (1-Click), não tem código BLIK nem formulário de cartão na página de finalização de compra, não permite escolher banco ou canal de pagamento na página de finalização de compra e usa um Service ID por ambiente.
Pedidos
Status do pedido
Pending payment: o cliente foi enviado à Autopay, e a Autopay ainda não confirmou o pagamento.
Processing or Completed: a Autopay confirmou o pagamento. O WooCommerce define o status Processando ou, para pedidos com apenas produtos digitais para download, Concluído. A nota do pedido mostra o valor, a transação na Autopay e a data do pagamento. O ID da transação é o ID da transação na Autopay (RemoteID).
On hold: a Autopay informou um valor ou uma moeda diferente do total do pedido. O pedido não foi marcado como pago. Verifique a transação no portal da Autopay e conclua ou reembolse manualmente.
Failed: o pagamento falhou. O cliente pode pagar novamente a partir do pedido.
Um pedido pago nunca é alterado por uma notificação de falha posterior. Se a Autopay informar outro pagamento bem-sucedido para um pedido já pago, uma nota avisa que o cliente pode ter pago duas vezes. Uma notificação de pagamento iniciado com outro serviço Autopay não é aplicada, e uma nota explica o motivo.
Reembolsos
Reembolsos pelo WooCommerce não são compatíveis. Faça o reembolso do pagamento no portal da Autopay e, depois, registre-o no WooCommerce com um reembolso manual.
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 > Autopay. 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 em 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 em vibefox.net.
Sem uma chave ativa, a Autopay não é mostrada 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. Gerentes da loja logados ainda veem 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 Plugins e nas páginas do WooCommerce. Pedidos existentes não são afetados: pagamentos já iniciados continuam sendo confirmados.
Quando uma licença expira, o plugin continua funcionando, mas atualizações e suporte precisam de renovação. O status é verificado novamente em segundo plano, automaticamente.
Solução de problemas
A Autopay não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ativado, se o ambiente selecionado tem Service ID e Shared key e se a moeda da loja está selecionada em Currencies. A página de configurações mostra um aviso quando algum desses itens falta.
O pagamento foi feito, mas o pedido continua com o status Pending payment: a Autopay não entregou a ITN, ou a loja a rejeitou. Verifique se a URL de ITN exibida nas configurações está definida para o serviço no portal da Autopay (produção ou teste), se a função hash é SHA-256 e se a Shared key do plugin corresponde ao serviço. Verifique se a loja está acessível pela internet. Ative Logging e consulte WooCommerce > Status > Logs, origem wcp_autopay_payment.
O log mostra ITN rejected: invalid hash: a Shared key não corresponde ao serviço, ou a função hash do serviço não é SHA-256.
O log mostra que o service ID não está configurado: a notificação veio de um serviço cujo Service ID não foi inserido no plugin.
O pedido foi colocado em espera com uma nota de divergência: a Autopay informou um valor ou uma moeda diferente do total do pedido. Verifique a transação no portal da Autopay e conclua ou reembolse o pedido manualmente.
Uma nota diz que a notificação NOT applied: o pagamento desse pedido não foi iniciado com este serviço Autopay, por exemplo uma notificação de teste para um pedido real. Verifique a transação no portal da Autopay.
Depois de pagar, o cliente cai na página inicial: o endereço de retorno não pôde ser verificado, por exemplo porque o Service ID não foi inserido no plugin. O status do pedido não é afetado; ele segue a ITN.
O bloco de licença mostra um erro: siga a mensagem exibida no bloco. Por exemplo, se a chave já estiver em uso em outro domínio, libere uma vaga na sua conta em 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 acessado, o plugin continua funcionando com o último status conhecido.
Desinstalação
Desativar o plugin mantém todos os dados. Para removê-lo, desative-o e exclua-o na página Plugins. A chave de licença, o status de licença e as configurações do gateway deste plugin são removidos. O plugin não tem opção para manter as configurações. Pedidos existentes mantêm suas notas de pagamento e IDs de transação.
A Autopay é uma marca registrada de seu respectivo titular. Este plugin não é afiliado nem endossado pela Autopay.