VibeFox Moneris for WooCommerce — Ajuda

Requisitos

WordPress: 6.0 ou superior.

WooCommerce: 8.0 ou superior, instalado e ativo. Sem o WooCommerce, o plugin não é ativado.

PHP: 8.0 ou superior.

Moeda da loja: CAD para uma conta canadense da Moneris, USD para uma conta antiga da Moneris USA. O gateway só é exibido quando a moeda do pedido corresponde à da conta.

HTTPS e PCI DSS: os números de cartão são digitados na sua finalização de compra e passam pelo seu servidor. Pagamentos reais exigem HTTPS e conformidade com PCI DSS SAQ D. Se você não puder atender a isso, use uma solução de página de pagamento hospedada.

Conta Moneris: você precisa do Store ID e do API Token da sua loja Moneris Gateway, disponíveis no Moneris Merchant Resource Center > Admin > Store Settings. Para testes, a loja de teste pública da Moneris já vem preenchida. As credenciais de teste e os cartões de teste estão no portal para desenvolvedores da Moneris.

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_moneris_gateway para /wp-content/plugins/ por FTP.

2. Clique em Activate.

3. Abra as configurações: WooCommerce > Settings > Payments > Moneris > Manage, ou clique em Settings abaixo do nome do plugin na página Plugins.

4. Digite sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.

5. Escolha o país da conta e preencha o Live Store ID e o Live API Token. O modo de teste vem ativado por padrão e usa a loja de teste pública (store5 / yesguy para o Canadá, monusqa002 / qatoken para os EUA).

6. Escolha Purchase ou Pre-Authorization e os logotipos dos cartões, depois ative Enable / Disable.

7. Faça um pedido de teste com um cartão de teste da Moneris e, em seguida, desmarque Test mode.

Configuração

Todas as configurações ficam em uma única página: WooCommerce > Settings > Payments > Moneris. Acima dos campos, a página mostra Moneris gateway is in TEST MODE. No real charges will be made. enquanto o modo de teste estiver ativo. No modo real, ela avisa quando os campos reais contêm credenciais de teste da Moneris (então o gateway fica oculto na finalização de compra) e quando o site não usa HTTPS. Também avisa quando a moeda da loja não é a moeda da conta Moneris; nesse caso, o gateway fica oculto na finalização de compra.

Geral

Enable / Disable: Enable Moneris Gateway ativa ou desativa o método de pagamento. Padrão: desativado.

Title: o nome do método de pagamento que o cliente vê. Padrão: Credit card (Moneris). No modo de teste, (Test Mode) é acrescentado ao título na finalização de compra.

Description: o texto exibido acima dos campos do cartão na finalização de compra. Padrão: Pay securely with your credit card.

Conta Moneris

Seu Store ID e seu API Token estão no Moneris Merchant Resource Center, em Admin > Store Settings. As credenciais de teste e os cartões de teste estão no portal para desenvolvedores da Moneris. A seção contém links para os dois.

Moneris account country: contas canadenses cobram em CAD, contas dos EUA em USD. O gateway só é exibido quando a moeda do pedido corresponde. Padrão: Canada (CAD).

Test mode: Enable test mode (Moneris QA gateway, test credentials, no real charges). Reembolsos, capturas e anulações são sempre enviados ao ambiente em que o pagamento foi feito. Os clientes veem TEST MODE: use a Moneris test card, no real charges are made. acima dos campos do cartão. Padrão: ativado.

Live Store ID: o Store ID de produção, por exemplo monca01234.

Live API Token: o API Token de produção.

Test Store ID: a loja de teste pública da Moneris: store5 (Canadá) ou monusqa002 (EUA). Padrão: store5.

Test API Token: o token de teste público: yesguy (Canadá) ou qatoken (EUA). Padrão: yesguy.

Pagamento

Transaction type: como o cartão é cobrado. Padrão: Purchase.

Card logos: os logotipos das bandeiras de cartão exibidos ao lado do título do método de pagamento: Visa, Mastercard, Discover, American Express, JCB. As bandeiras aceitas dependem da sua conta Moneris. Padrão: Visa and Mastercard.

Avançado

Debug log: Log API requests and responses (card number, CVV, expiry and API token are masked). Erros são sempre registrados. Veja o registro em WooCommerce > Status > Logs, origem wcp_moneris_gateway. Padrão: desativado.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted. Padrão: desativado.

Finalização de compra

O cliente escolhe o método de pagamento (por padrão, Credit card (Moneris)) e digita o número do cartão, a validade e o código de segurança no formulário de cartão do WooCommerce na sua finalização de compra. Quando o pedido é feito, o seu servidor envia o cartão à Moneris pelo total do pedido e recebe o resultado na hora. Não há redirecionamento nem webhook. O código de segurança (CVD) é sempre enviado, então as regras eFraud da sua loja Moneris continuam valendo.

Um pagamento aprovado só é marcado como pago quando a Moneris informa que a transação está concluída e o valor processado é igual ao total do pedido. Depois, o cliente vai para a página de pedido recebido. Com Pre-Authorization, o pedido fica em Em espera até você capturar os valores.

Se o cartão for recusado, o cliente vê Your card was declined com o motivo informado pela Moneris e pode conferir os dados do cartão ou usar outro. Se a Moneris não conseguir processar a solicitação (por exemplo, um Store ID ou API Token incorreto), o cliente vê The payment could not be processed. Please try again or use another payment method. O motivo é adicionado às notas do pedido e ao registro. Um segundo clique enquanto um pagamento está sendo processado mostra A payment for this order is already being processed. Please wait a moment and check your order status before trying again. Um pedido pago ou pré-autorizado nunca é cobrado novamente.

Se a Moneris não responder (erro de rede ou tempo esgotado), o plugin envia à Moneris um Status Check para descobrir se a transação foi concluída. Se isso também não for possível, o pedido vai para Em espera com o ID do pedido na Moneris, e o cliente não é convidado a pagar uma segunda vez.

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 WooCommerce High-Performance Order Storage (HPOS).

O plugin não tem cartões salvos nem Moneris Vault, nem WooCommerce Subscriptions, nem Apple Pay, Google Pay ou Interac Online, nem Moneris Checkout ou Hosted Tokenization, nem 3-D Secure, AVS ou Kount, nem preços em várias moedas.

Pedidos e reembolsos

Status do pedido

Pagamento pendente: o pedido foi criado e o cartão ainda não foi cobrado, por exemplo após uma tentativa recusada. A nota do pedido mostra o código e a mensagem da Moneris. O cliente pode pagar de novo.

Processando: a compra foi aprovada. Pedidos com apenas produtos virtuais para download passam a Concluído, o padrão do WooCommerce. A nota do pedido mostra o valor, o ID da transação na Moneris e o recibo. O ID da transação é o número da transação na Moneris.

Em espera: uma pré-autorização foi aprovada e aguarda a captura, o valor processado foi diferente do total do pedido ou a Moneris não confirmou o resultado. A nota do pedido explica o motivo.

Cancelado: para um pedido pré-autorizado, cancelar libera os valores reservados (anulação).

Captura e anulação

Para capturar uma pré-autorização, mude o status do pedido para Processando ou Concluído, ou escolha Capture Moneris pre-authorization nas ações do pedido. Será capturado o total atual do pedido menos os reembolsos; ele não pode ultrapassar o valor autorizado. Se a Moneris recusar a captura, o status volta para Em espera com uma nota, e nenhum e-mail de pedido em processamento ou concluído é enviado. As pré-autorizações da Moneris expiram após alguns dias, então capture-as a tempo.

Para liberar os valores, cancele o pedido ou escolha Void Moneris pre-authorization (cancel order) nas ações do pedido. Mudar o pedido para Reembolsado também libera uma pré-autorização aberta. Se a liberação falhar, uma nota pede que você a libere no Merchant Resource Center.

Reembolsos

Abra o pedido, clique em Refund, informe o valor e clique em Refund via Credit card (Moneris) (o botão mostra o seu Title). Reembolsos totais e parciais são aceitos. Uma pré-autorização só pode ser reembolsada depois de capturada; antes disso, cancele o pedido para liberar os valores. O reembolso é enviado ao ambiente e à conta em que o pagamento foi feito, então as credenciais desse modo precisam estar preenchidas. Se a Moneris não aceitar o reembolso, o WooCommerce mostra Refund failed com o motivo, e nenhum reembolso é registrado. Um reembolso bem-sucedido é adicionado às notas do pedido com o ID da transação na Moneris.

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 > Moneris. 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 na 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 na sua conta na vibefox.net.

Sem uma chave ativa, a Moneris 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 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 Plugins e nas páginas do WooCommerce. Os pedidos existentes não são afetados: capturas, anulações e reembolsos continuam funcionando.

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

A Moneris não aparece na finalização de compra: verifique se a licença está ativa, se Enable / Disable está ligado e se o modo atual tem Store ID e API Token. No modo real, os campos reais devem conter as suas credenciais de produção, não as credenciais de teste da Moneris. Confira se a moeda da loja (ou a moeda do pedido na página Pay for order) é a moeda da conta: CAD para o Canadá, USD para uma conta dos EUA. A página de configurações mostra um aviso quando a moeda não corresponde.

O pagamento foi feito, mas o pedido continua em Pagamento pendente ou Em espera: o plugin não tem webhook; o resultado vem apenas da resposta da Moneris. Se o pedido está em Em espera com uma nota dizendo que a Moneris não confirmou o resultado, a Moneris não respondeu e o Status Check também falhou. Procure o ID do pedido na Moneris indicado na nota no Merchant Resource Center: se a transação estiver lá, envie o pedido (e reembolse por lá, se necessário); se não estiver, cancele o pedido ou peça ao cliente que pague novamente.

O cliente vê Payment gateway is misconfigured. Please contact the store administrator.: as credenciais do modo atual estão faltando, ou o modo real está ativo com credenciais de teste da Moneris nos campos reais. Informe seu Store ID e seu API Token de produção.

O cliente vê This payment method does not support the order currency.: a moeda do pedido não é a moeda da conta Moneris.

O cliente vê um erro ao pagar: abra as notas do pedido ou ative Debug log e veja WooCommerce > Status > Logs, origem wcp_moneris_gateway.

A captura falha: o pedido não tem uma pré-autorização aguardando captura, o total do pedido é zero ou o valor é maior que o valor autorizado. As pré-autorizações da Moneris também expiram após alguns dias.

Reembolso, captura ou anulação falha com uma mensagem sobre o modo ou a conta: o pagamento foi feito no modo de teste ou no modo real, e as credenciais desse modo não estão preenchidas, ou o pagamento foi feito com uma conta Moneris do outro país. Preencha as credenciais ou processe o pagamento no Merchant Resource Center.

Ataques de card testing: formulários de cartão diretos são alvo de card testing. Ative a limitação de taxa da finalização de compra do WooCommerce, um plugin de CAPTCHA e as regras eFraud ou de velocidade na sua conta Moneris.

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 na 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 on uninstall estiver ativado. Caso contrário, permanecem para uma reinstalação futura. Os pedidos existentes mantêm suas notas de pagamento e IDs de transação.

Moneris é uma marca registrada de seu respectivo proprietário. Este plugin não é afiliado nem endossado pela Moneris.