VibeFox Montonio for WooCommerce — Ajuda

Requisitos

WordPress: 6.0 ou superior.

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

PHP: 8.0 ou superior.

Moeda: a moeda da loja ou do pedido deve ser EUR ou PLN. Para qualquer outra moeda, a forma de pagamento fica oculta na finalização de compra.

Conta Montonio: você precisa da chave de acesso e da chave secreta da sua loja, obtidas no Montonio Partner System. As chaves de sandbox e de produção são diferentes, então é preciso um par para cada ambiente que você usar. Nada mais precisa ser configurado na Montonio: o endereço de notificação é enviado com cada pagamento.

Site público: seu site precisa estar acessível pela internet para receber as notificações da Montonio. Caso contrário, os pedidos são confirmados quando o cliente volta à loja.

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

2. Clique em Activate.

3. Abra as configurações: WooCommerce > Settings > Payments > Montonio > 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. No Montonio Partner System, abra Stores > your store > API keys e copie a chave de acesso e a chave secreta de sandbox. Cole-as nas configurações e mantenha Sandbox mode ativado.

6. Ative Enable/Disable e teste um pagamento no sandbox. Depois, informe as chaves de produção e desmarque Sandbox mode.

Configuração

Todas as configurações ficam em uma única página: WooCommerce > Settings > Payments > Montonio. Acima dos campos, a página avisa quando faltam as chaves do ambiente atual (nesse caso a forma de pagamento fica oculta na finalização de compra) e quando a moeda da loja não é EUR nem PLN, e mostra Sandbox mode is on: payments are simulated and no real money is charged. enquanto o sandbox estiver ativo. Na lista de formas de pagamento, a Montonio aparece como precisando de configuração até que as duas chaves do ambiente atual estejam preenchidas.

Geral

Enable/Disable: Enable Montonio bank payments ativa ou desativa a forma de pagamento. Padrão: desativado.

Title: o nome da forma de pagamento que o cliente vê na finalização de compra. Padrão: Bank payment (Montonio).

Description: o texto exibido abaixo da forma de pagamento na finalização de compra. Padrão: Pay directly from your bank account. You will be redirected to Montonio to choose your bank.

Chaves de API

Obtenha as chaves no Montonio Partner System, em Stores > your store > API keys. As chaves de sandbox e de produção são diferentes. O sandbox usa somente as chaves de sandbox, e o modo de produção usa somente as chaves de produção. Esta seção das configurações também mostra o endereço de notificação. Ele tem este formato: https://your-site/wc-api/wc_mnt_payment/. Você não precisa informá-lo em lugar nenhum: o plugin o envia à Montonio com cada pagamento.

Sandbox mode: Use the Montonio sandbox (test payments, no real money). Ele troca tanto o endereço da API da Montonio quanto o par de chaves. Padrão: ativado. Desative-o somente depois de informar as chaves de produção.

Sandbox access key: a chave de acesso (UUID) da sua loja no sandbox da Montonio.

Sandbox secret key: a chave secreta da sua loja no sandbox da Montonio.

Live access key: a chave de acesso (UUID) da sua loja no ambiente de produção da Montonio.

Live secret key: a chave secreta da sua loja no ambiente de produção da Montonio.

Avançado

Debug log: Log payment events grava todos os eventos de pagamento em WooCommerce > Status > Logs, origem wcp_montonio_payment. Erros são sempre registrados, mesmo com esta opção desativada. Chaves, tokens e dados de clientes nunca são registrados. Padrão: desativado.

Delete data: Delete the gateway settings and logs when the plugin is deleted. Desativar o plugin nunca apaga nada. Os dados dos pedidos (UUIDs da Montonio, notas) são sempre mantidos. Padrão: desativado.

Notificações de pagamento

A Montonio informa à sua loja sobre cada pagamento com um token assinado. O token chega de duas formas: por uma notificação servidor a servidor para o endereço de notificação e com o cliente quando ele volta à loja. Ambos são verificados: a assinatura com sua chave secreta, a data de expiração, sua chave de acesso e se o pagamento é um que a sua loja criou para aquele pedido no mesmo ambiente. Tokens que não passam na verificação são recusados. Cada status é aplicado apenas uma vez, então notificações repetidas não adicionam notas, e-mails nem alterações de estoque.

Finalização de compra

O cliente escolhe a forma de pagamento (por padrão, Bank payment (Montonio)) e faz o pedido. O plugin cria um pagamento Montonio pelo total do pedido na moeda do pedido e envia o cliente para a página de pagamento da Montonio. Lá o cliente escolhe um banco e paga. Os bancos do país de cobrança do cliente aparecem primeiro (Polônia para pedidos em PLN). O pagamento aparece como Order e o número do pedido. A página da Montonio abre no idioma da loja quando ele é alemão, inglês, estoniano, finlandês, lituano, letão, polonês ou russo; caso contrário, abre em inglês. No modo sandbox, a finalização de compra mostra SANDBOX MODE — test payment, no real money is charged. abaixo da descrição.

O pedido só é marcado como pago depois que a Montonio confirma com status PAID e com o valor e a moeda exatos do pedido. Após pagar, o cliente retorna à página de pedido recebido da sua loja. Enquanto a Montonio ainda não tiver confirmado o pagamento, essa página mostra Montonio has not confirmed your payment yet. The order is updated as soon as the bank confirms it, and you will receive an e-mail then. Se o pagamento foi cancelado ou recusado, o cliente volta para a página Pay for order e vê uma destas mensagens: The payment was cancelled or rejected by the bank. You can try again or choose another payment method., The payment was not completed. You can try again or choose another payment method. ou Montonio could not complete the payment. Please try again or choose another payment method.

Um cliente pode pagar novamente um pedido não pago pela página Pay for order. Antes de criar um novo pagamento, o plugin consulta a Montonio sobre o anterior. Se ele já estiver pago, o pedido é confirmado e nenhum segundo pagamento é criado.

Se a Montonio não conseguir iniciar o pagamento, o cliente vê uma mensagem curta, por exemplo Montonio is temporarily unavailable. Please try again in a few minutes or choose another payment method., e pode escolher outra forma de pagamento. O erro da Montonio é adicionado às notas do pedido e ao registro.

A forma 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 aceita apenas pagamentos bancários (iniciação de pagamento). Não há pagamentos com cartão, BLIK, Apple Pay ou Google Pay, Pay Later ou financiamento, envio pela Montonio, assinaturas, formas de pagamento salvas nem seleção de banco no seu próprio site.

Pedidos e reembolsos

Status do pedido

Pagamento pendente: o cliente foi enviado à Montonio e ainda não pagou. Uma nota é adicionada quando a Montonio informa que o pagamento está pendente.

Processando ou Concluído: a Montonio confirmou o pagamento (PAID). O pedido segue o status padrão do WooCommerce para pedidos pagos. A nota do pedido mostra o banco, o UUID do pagamento na Montonio, o valor e o ambiente. O ID da transação é o UUID do pagamento na Montonio.

Em espera: o banco ainda não confirmou o pagamento (AUTHORIZED); o pedido fica pago quando a Montonio informar PAID. Um pedido também é colocado em espera quando a Montonio informou um valor ou uma moeda diferentes do total do pedido, quando um pagamento de sandbox chegou com a loja no modo de produção, ou quando o pagamento chegou depois que o pedido foi cancelado. A nota do pedido explica o motivo. Verifique o pagamento no Montonio Partner System e então envie o pedido ou reembolse o pagamento.

Falhou: o cliente não concluiu o pagamento ou o banco o recusou. Somente o último pagamento de um pedido não pago pode fazer o pedido falhar. O cliente pode tentar de novo pela página Pay for order.

Pedidos pagos, cancelados ou reembolsados nunca são reabertos por notificações posteriores. Se chegar um segundo pagamento para um pedido que já está pago, o pedido não é alterado. Uma nota pede que você reembolse o segundo pagamento no Montonio Partner System.

Reembolsos

Abra o pedido, clique em Refund, informe o valor e clique em Refund via Bank payment (Montonio) (o botão usa o título da forma de pagamento). Reembolsos totais e parciais são aceitos para pedidos pagos pela Montonio. O reembolso é enviado ao ambiente em que o pagamento foi feito (sandbox ou produção), então as chaves desse ambiente precisam estar configuradas. Se a Montonio não aceitar o reembolso, o WooCommerce mostra o erro e nenhum reembolso é registrado. Um reembolso enviado é adicionado às notas do pedido com seu status e o ID de reembolso da Montonio.

A Montonio confirma ou recusa cada reembolso depois, por uma notificação. Uma confirmação é adicionada às notas do pedido. Se a Montonio recusar o reembolso, a nota informa que o dinheiro não foi devolvido ao cliente; verifique no Montonio Partner System e corrija o reembolso no WooCommerce.

Reembolsos feitos no Montonio Partner System são adicionados às notas do pedido quando a Montonio os informa. Eles não são registrados automaticamente como reembolsos do WooCommerce. Se necessário, 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 > Montonio. 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 Montonio 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 a forma de pagamento, marcada 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: pagamentos já iniciados continuam sendo confirmados, e os reembolsos funcionam.

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 Montonio não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ligado, se as duas chaves do ambiente atual estão preenchidas (Sandbox access key e Sandbox secret key no modo sandbox, Live access key e Live secret key no modo de produção) e se a moeda da loja ou do pedido é EUR ou PLN. A página de configurações mostra um aviso quando faltam chaves ou a moeda não é suportada.

O pagamento foi feito, mas o pedido continua em Pagamento pendente: a notificação não chegou à sua loja. Verifique se o site está acessível pela internet e se as chaves nas configurações pertencem ao ambiente do pagamento. O pedido também é confirmado quando o cliente volta à loja depois de pagar, e quando ele tenta pagar o mesmo pedido de novo.

A notificação responde Invalid token: a assinatura do token, a expiração ou a chave de acesso não conferiram. Verifique se a chave de acesso e a chave secreta foram copiadas corretamente, se pertencem ao ambiente certo e se o relógio do servidor está correto.

A notificação responde Payment does not belong to this order ou Wrong environment: o pagamento não foi criado por esta loja para este pedido, ou foi criado no outro ambiente (sandbox ou produção). Isso acontece quando duas lojas usam a mesma conta Montonio e os mesmos números de pedido.

A notificação responde Gateway not configured: não há chaves da Montonio configuradas. Informe as chaves; a Montonio vai repetir a notificação.

O cliente vê um erro ao fazer o pedido: abra as notas do pedido ou ative Debug log e veja WooCommerce > Status > Logs, origem wcp_montonio_payment. This payment method is temporarily unavailable. Please choose another payment method. normalmente indica chaves erradas ou ausentes. Montonio could not start the payment. Please check your order details or choose another payment method. significa que a Montonio recusou os dados do pagamento; a nota traz o motivo.

O pedido fica em Em espera depois do pagamento: leia a nota do pedido. O banco ainda não confirmou o pagamento, o valor ou a moeda pagos não correspondem ao pedido, um pagamento de sandbox chegou no modo de produção, ou o pagamento chegou depois que o pedido foi cancelado. Verifique o pagamento no Montonio Partner System.

Pagamentos de sandbox não confirmam um pedido de produção: um pagamento de sandbox nunca conclui um pedido enquanto a loja estiver no modo de produção; o pedido é colocado em espera. Mude Sandbox mode para o ambiente que deseja usar e utilize as chaves desse ambiente.

O reembolso falha com uma mensagem sobre o ambiente: o pagamento foi feito no ambiente sandbox ou de produção, e as chaves desse ambiente não estão configuradas. Informe-as e tente novamente.

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 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.

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