VibeFox Paysera for WooCommerce — Ajuda
Requisitos
WordPress: 6.0 ou posterior.
WooCommerce: 7.0 ou posterior, instalado e ativo. O plugin não ativa sem ele.
PHP: 8.0 ou posterior.
Projeto Paysera: você precisa do ID do projeto e da senha do projeto (chave de assinatura) do seu projeto Paysera. Os métodos de pagamento que o cliente vê são os ativados neste projeto. Nada precisa ser configurado na Paysera para o callback: a URL dele é enviada com cada solicitação de pagamento.
Site acessível: os pedidos são pagos pelo callback da Paysera, por isso o seu site precisa estar acessível pela internet, sem estar atrás de login, modo de manutenção ou firewall.
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_paysera_payment para /wp-content/plugins/ por FTP.
2. Clique em Activate.
3. Abra as configurações: WooCommerce > Settings > Payments > Paysera > Manage, ou clique em Settings abaixo do nome do plugin na página de Plugins.
4. Informe a sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.
5. Informe o Project ID e a Project password da sua conta Paysera (veja Configuração).
6. Opcional: ative Allow test payments no projeto Paysera e Test payments no plugin para testar o fluxo sem cobrar dinheiro. Desative antes de começar a vender.
7. Ative Enable/Disable e salve.
Configuração
Todas as configurações ficam em uma única página: WooCommerce > Settings > Payments > Paysera. Acima dos campos, a página mostra O Paysera fica oculto na finalização da compra até que o ID do projeto e a senha do projeto sejam informados. enquanto um dos dois estiver faltando, e um aviso de que os clientes não são cobrados enquanto os pagamentos de teste ou o sandbox estiverem ativos. Na lista de métodos de pagamento, o Paysera aparece como pendente de configuração até que o projeto esteja configurado, e exibe um selo de modo de teste quando os pagamentos de teste ou o sandbox estão ativos.
Geral
Enable/Disable: Enable Paysera Payment ativa ou desativa o método de pagamento. Padrão: desativado.
Title: o nome do método de pagamento exibido na finalização da compra. Padrão: Paysera.
Description: o texto exibido abaixo do método de pagamento na finalização da compra. Padrão: Pay securely via Paysera.
Projeto Paysera
Você encontra o ID do projeto e a senha do projeto na sua conta Paysera, em Projects and activities, no seu projeto, em General project settings. A seção mostra a URL do callback, que tem este formato: https://your-site/wc-api/wc_psr_payment/. Ela é enviada automaticamente com cada pagamento; nada precisa ser configurado na Paysera.
Project ID: o ID numérico do seu projeto Paysera.
Project password: a senha do projeto (chave de assinatura). Ela assina as solicitações de pagamento e verifica os callbacks da Paysera.
Testes
Test payments: Send payments in test mode (no money is charged). A Paysera devolve um pagamento de teste bem-sucedido sem cobrar o cliente. Ative antes Allow test payments nas configurações do projeto Paysera. Enquanto essa opção estiver ativa, os pagamentos de teste marcam os pedidos como pagos; quando estiver desativada, um pagamento de teste nunca paga um pedido. Padrão: desativado.
Environment: para onde o cliente é enviado. Mantenha Production para um projeto Paysera normal, inclusive para pagamentos de teste. Padrão: Production.
Avançado
Debug log: Log payment events. Erros são sempre registrados. Os registros ficam em WooCommerce > Status > Logs, origem wcp_paysera_payment. Senhas e dados de clientes nunca são gravados. Padrão: desativado.
Delete data: Delete the plugin settings and logs when the plugin is deleted. Desativar o plugin nunca apaga nada. Os dados dos pedidos são sempre mantidos. Padrão: desativado.
Finalização da compra
O cliente escolhe o método de pagamento (por padrão Paysera) e faz o pedido. Com os pagamentos de teste ativos, a finalização da compra mostra MODO DE TESTE — nenhum valor será cobrado. O plugin cria uma solicitação de pagamento assinada com o total do pedido na unidade mínima da moeda do pedido, o nome, o e-mail e o endereço de cobrança do cliente, e um idioma escolhido de acordo com o idioma do seu site (lituano, letão, estoniano, russo, alemão, polonês ou, caso contrário, inglês). O cliente é enviado à janela de pagamento da Paysera e escolhe lá um banco, um cartão ou outro método.
Depois de pagar, o cliente volta para a página de pedido recebido. O pedido só é marcado como pago quando o callback assinado da Paysera chega; o retorno em si nunca paga um pedido.
Se o cliente cancelar na janela da Paysera, o pedido é cancelado da forma padrão do WooCommerce, e o cliente pode fazer um novo pedido. Se o pagamento não puder ser iniciado, o cliente vê Os pagamentos Paysera estão temporariamente indisponíveis. Escolha outro método de pagamento. O motivo é gravado no registro.
O método de pagamento funciona na finalização de compra clássica, no bloco Finalizar compra e na página Pay for order. É compatível com o WooCommerce High-Performance Order Storage (HPOS).
O plugin não oferece reembolsos pelo WooCommerce, nenhuma escolha de banco ou método de pagamento na finalização da compra, nem assinaturas, cartões salvos ou serviços de entrega ou courier da Paysera.
Pedidos
Status do pedido
Pending payment: o cliente foi enviado para a Paysera e o callback ainda não chegou.
Processing: a Paysera confirmou o pagamento (status 1). Pedidos com apenas produtos virtuais para download passam para Concluído, o padrão do WooCommerce. A nota do pedido mostra a solicitação da Paysera e o método de pagamento. O ID da transação é o ID da solicitação da Paysera.
On hold: a Paysera aceitou a ordem de pagamento, mas ainda não a executou (status 2), e o pedido é concluído quando a Paysera confirmar o pagamento; ou o valor ou a moeda pagos diferem do pedido (nota amount/currency mismatch); ou foi recebido um pagamento de TESTE enquanto os pagamentos de teste estavam desativados, por isso nenhum dinheiro foi cobrado. A nota do pedido explica.
Cancelled: o cliente cancelou na janela da Paysera, ou o pedido foi cancelado por você ou pelo tempo limite da reserva de estoque. Um pagamento confirmado depois para um pedido cancelado não muda o status dele: uma nota pede que você restaure o pedido (colocando-o em Processing) ou reembolse o pagamento na Paysera.
Outros status da Paysera (pagamento não executado, informações adicionais) apenas acrescentam uma nota. Se chegar outro pagamento bem-sucedido para um pedido que já está pago, o pedido não é alterado, e uma nota pede que você reembolse o pagamento duplicado na sua conta Paysera.
Reembolsos
Reembolsos pelo WooCommerce não são suportados: o protocolo da janela de pagamento da Paysera não tem API de reembolso. Faça os reembolsos na sua conta Paysera. Quando a Paysera informa um reembolso, uma nota com o valor reembolsado é adicionada ao pedido, e o status do pedido não muda. Registre o reembolso manualmente no WooCommerce, se necessário.
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 > Paysera. 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 informar outra chave e Remove key para removê-la deste site. O link Manage licenses and domains in your account abre a sua conta vibefox.net.
Uma chave funciona em um domínio. Remover a chave de um site não libera a vaga de domínio. Libere a vaga na sua conta vibefox.net.
Sem uma chave ativa, o Paysera não é exibido aos clientes na finalização da compra. Se um pagamento for iniciado mesmo assim, o cliente vê This payment method is not available. Please choose another one. Os gerentes da loja conectados 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 de Plugins e nas páginas do WooCommerce. Os pedidos existentes não são afetados: os pagamentos já iniciados continuam sendo confirmados.
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 Paysera não aparece na finalização da compra: verifique se a licença está ativa, se Enable/Disable está ligado e se Project ID e Project password estão preenchidos. A página de configurações mostra um aviso enquanto algum deles estiver faltando.
O pagamento foi feito, mas o pedido continua em Pending payment: o pedido é pago pelo callback da Paysera, não pelo retorno do cliente. Verifique se o seu site está acessível pela internet na URL do callback mostrada nas configurações (sem estar atrás de login, modo de manutenção ou firewall) e consulte WooCommerce > Status > Logs, origem wcp_paysera_payment.
O callback responde Invalid signature: a Project password não corresponde ao projeto, ou o callback não veio da Paysera. Copie a senha do projeto novamente.
O callback responde Project ID mismatch: o Project ID das configurações é diferente do projeto que fez o pagamento.
O callback responde Gateway not configured ou Busy: o ID ou a senha do projeto estão vazios, ou outro callback do mesmo pedido ainda está em execução. A Paysera tenta o callback novamente.
A Paysera recusa a janela de pagamento ou diz que o projeto não existe: verifique Environment. Um projeto Paysera normal funciona apenas com Production; o Sandbox exige um projeto criado no ambiente sandbox da Paysera.
O pagamento de teste não paga o pedido: um pagamento de TESTE só paga um pedido enquanto Test payments estiver ativo. Caso contrário, o pedido fica em espera com uma nota informando que nenhum dinheiro foi cobrado. Ative também Allow test payments no projeto Paysera.
Nenhum ícone na finalização da compra: o plugin não mostra ícone por padrão. Desenvolvedores podem definir um com o filtro wc_psr_gateway_icon.
Um pedido está On hold com uma nota sobre divergência de valor ou moeda: a Paysera confirmou um pagamento cujo valor ou moeda não corresponde ao total do pedido, por exemplo porque o pedido foi editado depois que o cliente começou a pagar. Compare o pagamento na sua conta Paysera e conclua ou reembolse o pedido manualmente.
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 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 e o status de licença deste plugin são sempre removidos. As configurações do gateway e os registros só são removidos se Delete data estava ativado. Caso contrário, eles permanecem para uma reinstalação futura. Os pedidos existentes mantêm suas notas de pagamento e IDs de transação.
Paysera é uma marca comercial de seu respectivo titular. Este plugin não é afiliado nem endossado pela Paysera.