VibeFox 2C2P for WooCommerce — Ajuda
Requisitos
WordPress: 5.8 ou superior.
WooCommerce: 6.0 ou superior, instalado e ativo. Sem o WooCommerce, o plugin mostra um aviso na área administrativa e o método de pagamento não é carregado.
PHP: 8.0 ou superior.
Conta 2C2P: você precisa do Merchant ID e da chave secreta (Secret Key) da sua conta de comerciante 2C2P. A 2C2P os emite quando a conta de comerciante é aberta. Contas de sandbox e de produção têm chaves diferentes. A documentação para desenvolvedores e os cartões de teste do sandbox estão em developer.2c2p.com.
Moeda: a moeda da loja precisa ser compatível com o plugin e estar ativada na sua conta 2C2P. São compatíveis, entre outras, THB, SGD, MYR, PHP, IDR, VND, MMK, KHR, LAK, CNY, HKD, TWD, JPY, KRW, INR, AUD, NZD, USD, EUR e GBP. Se a moeda da loja não for compatível, o método de pagamento fica oculto na finalização de compra.
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_2c2p_payment para /wp-content/plugins/ por FTP.
2. Clique em Activate.
3. Abra as configurações: WooCommerce > Settings > Payments > 2C2P > 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 Merchant ID e a Secret Key do sandbox, ative Enable/Disable e faça um pedido de teste.
6. Quando estiver pronto, insira as credenciais de produção e desmarque Sandbox Mode.
As URLs de retorno e de notificação são enviadas em cada pagamento. Nada precisa ser configurado no portal da 2C2P.
Configuração
Todas as configurações estão em uma única página: WooCommerce > Settings > Payments > 2C2P. Acima dos campos, a página mostra Sandbox mode is active. No real transactions will be processed. enquanto o modo sandbox estiver ativo. Ela avisa quando o gateway está ativado, mas o Merchant ID ou a Secret Key do modo atual está vazio, e quando a moeda da loja não é compatível. Nos dois casos, o método de pagamento fica oculto na finalização de compra. Ao salvar com Sandbox Mode desativado, o plugin pede o Merchant ID e a Secret Key de produção, se estiverem vazios.
Geral
Enable/Disable: Enable 2C2P 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: 2C2P Payment.
Description: o texto exibido abaixo do método de pagamento na finalização de compra. Padrão: Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P. No modo sandbox, (TEST MODE) é acrescentado a ele.
Modo de teste (sandbox)
Sandbox Mode: Enable sandbox / test mode envia os pagamentos para o sandbox da 2C2P (demo2.2c2p.com), com as credenciais de sandbox abaixo. Padrão: ativado. Desmarque para receber pagamentos reais.
Sandbox Merchant ID: o seu Merchant ID de sandbox da 2C2P.
Sandbox Secret Key: a sua chave secreta de sandbox da 2C2P.
Credenciais de API de produção
Usadas quando o modo sandbox está desativado.
Merchant ID: o seu Merchant ID de produção da 2C2P. Obrigatório quando o modo sandbox está desativado.
Secret Key: a sua chave secreta de produção da 2C2P. Obrigatória quando o modo sandbox está desativado. A chave é salva exatamente como foi inserida, incluindo aspas e barras invertidas.
Página de pagamento
Esta seção mostra, para referência, a URL de retorno do front-end (https://your-site/?wc-api=tc2p_p) e a URL de notificação do back-end (https://your-site/?wc-api=tc2p_p&tc2p_p_s2s=1). Elas são enviadas automaticamente em cada pagamento.
Payment Page Language: o idioma da página de pagamento da 2C2P. Padrão: English.
Redirect API version: mantenha 8.5, a menos que a 2C2P tenha informado que a sua conta ainda usa a versão antiga 7.0 (assinaturas SHA-1). Resultados de pagamentos iniciados antes de uma troca continuam sendo verificados.
Order ID prefix: opcional, somente letras e números (máximo de 10), por exemplo SHOP1. A 2C2P rejeita um ID de pedido que ela já recebeu. Defina um prefixo exclusivo quando várias lojas compartilharem uma conta 2C2P, e também no sandbox, onde as contas de comerciante de teste são compartilhadas. Os outros caracteres são removidos ao salvar, com um aviso.
Configurações avançadas
Enable Logging: Log 2C2P events grava em WooCommerce > Status > Logs, origem wcp_2c2p_payment. Nenhum dado de cartão nem chave secreta é registrado. Padrão: desativado.
Delete Data on Uninstall: Delete the gateway settings, 2C2P order meta and log files when the plugin is deleted. Padrão: desativado.
Finalização de compra
O cliente escolhe o método de pagamento (por padrão, 2C2P Payment) e faz o pedido. A página seguinte mostra Thank you for your order. You will be redirected to 2C2P to complete your payment. e, depois de um instante, envia o cliente à página de pagamento da 2C2P. Se isso não acontecer, o cliente clica em Pay via 2C2P. A página também tem um botão Cancel order.
Na página da 2C2P, o cliente paga com qualquer método ativado na sua conta 2C2P, por exemplo cartões, carteiras digitais, pagamentos por QR code, internet banking ou pagamentos em dinheiro. O plugin envia o total do pedido na moeda do pedido, o e-mail de faturamento do cliente e os nomes dos produtos pedidos. O pagamento pode ser concluído em até 24 horas.
A 2C2P informa o resultado duas vezes: o navegador do cliente volta para a loja, e a 2C2P envia uma notificação servidor a servidor. Os dois são tratados da mesma forma. O pedido só é marcado como pago depois que a 2C2P confirma com uma assinatura válida. O resultado também precisa pertencer ao pedido: são verificados o Merchant ID, a chave do pedido, o ID do pedido e o método de pagamento. Resultados sem assinatura válida são rejeitados.
Depois de um pagamento concluído ou pendente, o cliente chega à página de pedido recebido e o carrinho é esvaziado. Se o pagamento não foi concluído, o cliente volta à finalização de compra com a mensagem Payment was not completed. Please try again or choose a different payment method. O pedido é cancelado, o carrinho é mantido e o cliente faz um novo pedido. Se o resultado não puder ser confirmado, o cliente vê We could not confirm the payment result. If your account was charged, please contact us before paying again.
O método de pagamento funciona na finalização de compra clássica e no bloco de Finalização de compra. É compatível com o armazenamento de pedidos de alto desempenho do WooCommerce (HPOS).
O plugin não faz reembolsos pelo WooCommerce, não salva cartões, não processa pagamentos recorrentes nem WooCommerce Subscriptions, não tem campos de cartão no seu site e não oferece suporte à API PGW 4.x da 2C2P.
Pedidos
Status do pedido
Pending payment: o cliente foi enviado à 2C2P e nenhum resultado chegou ainda.
Processing or Completed: a 2C2P informou um pagamento bem-sucedido (status 000). O WooCommerce define o status Processando ou, para pedidos com apenas produtos digitais para download, Concluído. A nota do pedido mostra a transação na 2C2P, o código de aprovação, a data e o canal de pagamento. O ID da transação é a referência de transação da 2C2P.
On hold: o pagamento está pendente na 2C2P (status 001), por exemplo um pagamento em dinheiro que o cliente ainda não fez. O pedido passa a pago quando a 2C2P informa o pagamento. Um pedido também fica em espera quando a 2C2P informa um valor ou uma moeda diferente do total do pedido. A nota do pedido mostra os valores recebidos e os esperados. Verifique o pedido e a transação no portal da 2C2P.
Cancelled: o pagamento foi recusado, cancelado pelo cliente ou falhou (status 002, 003, 999). A nota do pedido mostra o status e o motivo.
Um pedido pago ou reembolsado nunca é alterado por um resultado posterior, e um resultado antigo repetido não reabre um pedido que você cancelou.
Reembolsos
Reembolsos pelo WooCommerce não são compatíveis. Faça o reembolso do pagamento no portal de comerciante da 2C2P e, depois, crie um reembolso manual no 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 > 2C2P. 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 2C2P 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 2C2P não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ativado e se o modo atual tem Merchant ID e Secret Key: os campos de sandbox no modo sandbox, os campos de produção no modo de produção. Verifique se a moeda da loja é compatível. A página de configurações mostra um aviso nos dois casos.
O pagamento foi feito, mas o pedido continua com o status Pending payment: nenhum resultado válido chegou à sua loja. Verifique se o Merchant ID e a Secret Key do modo atual correspondem à conta 2C2P com que o pagamento foi feito, e se Redirect API version corresponde à sua conta. Um resultado com assinatura errada ou de outro Merchant ID é rejeitado. Ative Enable Logging e procure mensagens de hash ou de Merchant ID em WooCommerce > Status > Logs. Verifique também se o seu servidor aceita as requisições da 2C2P para a URL de notificação do back-end.
A 2C2P diz que o ID do pedido já existe: a 2C2P não aceita o mesmo ID de pedido duas vezes. Isso acontece quando várias lojas compartilham uma conta 2C2P, ou no sandbox, em que contas de comerciante de demonstração são compartilhadas por muitos desenvolvedores. Defina um Order ID prefix exclusivo.
Um pagamento foi feito, mas o pedido está On hold: ou o pagamento ainda está pendente na 2C2P (por exemplo, um pagamento em dinheiro que o cliente ainda não fez), ou o valor ou a moeda pagos não correspondiam ao pedido. Verifique as notas do pedido e a transação no portal da 2C2P.
O cliente vê a mensagem This payment method is currently unavailable for this order: a moeda do pedido não é compatível, ou o Merchant ID ou a Secret Key do modo atual está vazio.
Ao salvar, a mensagem Please enter your live Merchant ID or Please enter your live Secret Key indica que o modo sandbox está desativado e um campo de produção está vazio. Insira as credenciais de produção ou mantenha Sandbox Mode ativado.
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 e o status de licença deste plugin são sempre removidos. As configurações do gateway, os dados da 2C2P armazenados nos pedidos e os arquivos de log são removidos somente se Delete Data on Uninstall estava ativado. Caso contrário, permanecem para uma eventual reinstalação. Pedidos existentes mantêm suas notas de pagamento e IDs de transação.
A 2C2P é uma marca registrada de seu respectivo titular. Este plugin não é afiliado nem endossado pela 2C2P.