VibeFox MultiSafepay for WooCommerce — Ajuda

Requisitos

WordPress: 6.0 ou superior.

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

PHP: 8.0 ou superior.

Moeda: a moeda da loja ou do pedido deve ser uma que a MultiSafepay aceite, por exemplo EUR, USD, GBP, PLN, CHF, SEK, DKK ou NOK. Para outras moedas, o método de pagamento fica oculto no checkout.

Conta MultiSafepay: você precisa da chave de API do seu site no MultiSafepay Control. As contas de teste e de produção têm chaves diferentes. Não há mais nada a configurar na MultiSafepay: o endereço de notificação é enviado com cada pagamento.

Site público: a MultiSafepay precisa conseguir acessar o seu site para enviar notificações. Caso contrário, os pedidos ainda são atualizados quando o cliente volta da MultiSafepay.

Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um único domínio.

Instalação

1. No WordPress, vá em Plugins > Add New > Upload Plugin, escolha o arquivo ZIP do plugin e clique em Install Now. Você também pode enviar a pasta wcp_multisafepay_gateway para /wp-content/plugins/ por FTP.

2. Clique em Activate.

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

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

5. Cole a chave de API de teste e/ou de produção do MultiSafepay Control (veja Configuração).

6. Ative Enable/Disable e salve. Teste um pagamento com Test mode ativado e depois desmarque para aceitar pagamentos reais.

Configuração

Todas as configurações ficam em uma única página: WooCommerce > Settings > Payments > MultiSafepay. O título da página mostra um selo Test mode enquanto o modo de teste estiver ativo. Acima dos campos, a página avisa quando o modo atual não tem chave de API (nesse caso, o método de pagamento não é exibido no checkout) ou quando a MultiSafepay não aceita a moeda da loja. Na lista de métodos de pagamento, a MultiSafepay aparece como pendente de configuração até que o modo atual tenha uma chave de API.

Checkout

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

Title: o nome do método de pagamento que o cliente vê no checkout. Padrão: MultiSafepay.

Description: o texto exibido abaixo do método de pagamento no checkout. Padrão: Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay.

Chaves de API

Encontre a chave de API em MultiSafepay Control > Manage settings > Website settings. A conta de teste (testmerchant.multisafepay.com) e a conta de produção (merchant.multisafepay.com) têm chaves diferentes. O modo de teste usa somente a chave de teste, e o modo de produção usa somente a chave de produção.

Test mode: Use the MultiSafepay test environment (no real payments). Ele altera tanto o endereço da API quanto a chave de API. Pagamentos já feitos continuam usando o ambiente em que foram realizados para verificações de status e reembolsos. Padrão: ativado.

Test API key: a chave de API da sua conta de teste da MultiSafepay.

Live API key: a chave de API da sua conta de produção da MultiSafepay.

Notificações

Nada a configurar. Esta seção mostra o endereço de notificação, que é enviado à MultiSafepay com cada pagamento. Ele tem este formato: https://your-site/?wc-api=mspg_webhook. A MultiSafepay precisa conseguir acessar o seu site. Uma notificação apenas informa ao plugin qual pagamento mudou: o status, o valor e a moeda são sempre lidos da API da MultiSafepay com a sua chave de API antes de um pedido ser alterado. Notificações de pagamentos que não pertencem a um pedido da sua loja são ignoradas.

Pedidos

Order status after payment: o status de um pedido pago. O status é definido imediatamente, com uma única mudança de status e um e-mail ao cliente.

Avançado

Debug log: Log API calls and notifications grava os detalhes em WooCommerce > Status > Logs, origem wcp_multisafepay_gateway. Os erros são sempre registrados. Chaves de API e dados de clientes não são registrados. Padrão: desativado.

Delete data on uninstall: Remove settings, logs and MultiSafepay order data when the plugin is deleted. Desativar o plugin nunca apaga nada. Padrão: desativado.

Checkout

O cliente escolhe o método de pagamento (por padrão, MultiSafepay) e faz o pedido. O plugin cria um pagamento na MultiSafepay pelo total do pedido na moeda do pedido e envia o cliente para a página de pagamento da MultiSafepay. Lá, o cliente escolhe qualquer método de pagamento ativado na sua conta MultiSafepay e paga. Os dados de cobrança do cliente e o idioma da loja são transmitidos à MultiSafepay, e o pagamento aparece como Order #, o número do pedido e o nome do seu site. No modo de teste, o checkout mostra Test mode: no real payment will be made.

O estoque fica reservado enquanto o cliente paga, e o carrinho é mantido até a página de pedido recebido. Depois de pagar, o cliente volta para a página de pedido recebido da sua loja. O pedido só é marcado como pago depois que a MultiSafepay confirma: pela notificação ou por uma verificação com a API da MultiSafepay quando o cliente chega a essa página.

Se o cliente cancelar na página da MultiSafepay durante o checkout, o pedido é cancelado da forma padrão do WooCommerce, o estoque é liberado e os produtos permanecem no carrinho. Se o cliente estava pagando pela página Pay for order, ele volta para essa página, que explica o que aconteceu: The MultiSafepay payment was cancelled. You can try again or choose another payment method., The payment was declined. Please try again or choose another payment method. ou The payment session has expired. Please try again.

Um cliente pode pagar novamente um pedido não pago. Antes de criar um novo pagamento, o plugin verifica o anterior na MultiSafepay. Se ele já estiver pago, o pedido é confirmado. Se ainda estiver aberto com o mesmo valor, a mesma página de pagamento é reutilizada. Se o valor mudou, o pagamento anterior é cancelado na MultiSafepay, para que não possa mais ser pago.

Se a MultiSafepay não conseguir iniciar o pagamento, o cliente vê uma mensagem curta, por exemplo Could not connect to MultiSafepay. Please try again in a moment. ou MultiSafepay cannot accept this order amount or currency. Please choose another payment method., e pode escolher outro método de pagamento. O erro da MultiSafepay é adicionado às notas do pedido.

O método de pagamento funciona no checkout clássico, no bloco Checkout e na página Pay for order. É compatível com o WooCommerce High-Performance Order Storage (HPOS).

O plugin oferece um único método de pagamento que leva à página da MultiSafepay. Não há métodos de pagamento separados do WooCommerce para cada método da MultiSafepay, nem campos de cartão incorporados, nem botões expressos de Apple Pay ou Google Pay, nem assinaturas, pagamentos recorrentes ou cartões salvos, e não é possível capturar ou anular pelo WooCommerce. Nenhum dado do carrinho é enviado, por isso a MultiSafepay não oferece, para esses pedidos, os métodos de pagamento pós-pago que precisam dele (por exemplo, Klarna, in3 ou Riverty).

Pedidos e reembolsos

Status do pedido

Pending payment: você foi enviado à MultiSafepay e ainda não pagou.

Processing ou Completed: a MultiSafepay confirmou o pagamento (concluído ou enviado). O status segue Order status after payment. A nota do pedido mostra o ID do pagamento na MultiSafepay, o método de pagamento e o ambiente. O ID da transação é o ID do pedido da MultiSafepay referente ao pagamento.

On hold before payment: o pagamento não está liquidado (está sendo analisado pela MultiSafepay) ou está reservado (autorizado). Capture um pagamento reservado no MultiSafepay Control para receber o dinheiro. O pedido é concluído automaticamente quando a MultiSafepay informa que foi pago.

On hold after payment: a MultiSafepay confirmou um valor ou uma moeda diferentes do total do pedido, um pagamento de teste foi concluído enquanto a loja está no modo de produção (nenhum dinheiro real foi recebido), ou o pagamento foi concluído depois que o pedido havia sido cancelado. A nota do pedido explica. Verifique a transação no MultiSafepay Control e processe ou reembolse o pedido manualmente.

On hold after a chargeback: a MultiSafepay informou uma contestação em um pedido pago: o dinheiro foi retirado da sua conta.

Failed: o último pagamento de um pedido não pago foi recusado, cancelado, expirado ou anulado (void). O estoque retido é liberado. O cliente pode tentar novamente.

Um pedido pago, reembolsado ou cancelado nunca é reaberto por uma notificação atrasada. Se um segundo pagamento for concluído para um pedido que já está pago, o pedido não é alterado novamente. Uma nota pede que você reembolse a duplicata no MultiSafepay Control.

Reembolsos

Abra o pedido, clique em Refund, informe o valor e clique em Refund via MultiSafepay. Reembolsos totais e parciais são aceitos para pedidos pagos pela MultiSafepay. O reembolso é enviado ao ambiente em que o pagamento foi feito (teste ou produção), por isso a chave de API desse ambiente precisa estar configurada. Se a MultiSafepay não aceitar o reembolso, o WooCommerce mostra o erro da MultiSafepay e nenhum reembolso é registrado. Uma solicitação bem-sucedida é adicionada às notas do pedido com o ID do reembolso da MultiSafepay.

Reembolsos feitos no MultiSafepay Control são adicionados às notas do pedido quando a MultiSafepay os informa. Eles não são registrados automaticamente como reembolsos do WooCommerce. Se necessário, crie um reembolso manual no WooCommerce sem usar Refund via MultiSafepay.

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 > MultiSafepay. 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 na vibefox.net.

Uma chave funciona em um único domínio. Remover a chave de um site não libera a vaga de domínio. Libere a vaga na sua conta da vibefox.net.

Sem uma chave ativa, a MultiSafepay não é exibida aos clientes no checkout. 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 Plugins e nas páginas do WooCommerce. Os pedidos existentes não são afetados: os pagamentos já iniciados continuam sendo confirmados, e os reembolsos funcionam.

Quando uma licença expira, o plugin continua funcionando, mas atualizações e suporte precisam de renovação. O status é verificado novamente de forma automática em segundo plano.

Solução de problemas

A MultiSafepay não aparece no checkout: verifique se a licença está ativa, se Enable/Disable está ativado, se o modo atual tem uma chave de API (Test API key no modo de teste, Live API key no modo de produção) e se a moeda da loja ou do pedido é aceita pela MultiSafepay. A página de configurações mostra um aviso quando a chave está ausente ou a moeda não é aceita.

O pagamento foi feito, mas o pedido continua em Pending payment: a notificação não chegou à sua loja. Verifique se o site pode ser acessado pela internet e se a chave de API do ambiente do pagamento está configurada, pois o plugin lê o status pela API da MultiSafepay. Se a API não puder ser acessada, a notificação responde ERROR e a MultiSafepay tenta novamente. O pedido também é atualizado quando o cliente volta para a página de pedido recebido e quando tenta pagar o mesmo pedido novamente.

O cliente vê um erro ao fazer o pedido: abra as notas do pedido ou ative Debug log e consulte WooCommerce > Status > Logs, origem wcp_multisafepay_gateway. This payment method is temporarily unavailable. Please choose another payment method. normalmente indica uma chave de API incorreta ou ausente. MultiSafepay cannot accept this order amount or currency. Please choose another payment method. significa que a MultiSafepay recusou o valor ou a moeda.

O pedido está em On hold after payment: leia a nota do pedido. O pagamento pode estar não liquidado ou reservado, o valor ou a moeda pagos podem ser diferentes do pedido, um pagamento de teste pode ter chegado no modo de produção, o pagamento pode ter sido concluído depois que o pedido foi cancelado ou pode haver uma contestação. Verifique a transação no MultiSafepay Control.

Pagamentos de teste não confirmam um pedido real: um pagamento de teste nunca paga um pedido enquanto a loja está no modo de produção; o pedido é colocado em espera. Pagamentos de teste anteriores continuam sendo verificados e reembolsados com a chave de teste depois que você muda para produção.

O reembolso falha com uma mensagem sobre o ambiente: o pagamento foi feito no ambiente de teste ou de produção, e a chave de API desse ambiente não está configurada. Informe-a 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 da 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 da licença deste plugin são sempre removidos. As configurações do gateway, os dados da MultiSafepay armazenados nos pedidos e os logs 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.

MultiSafepay é uma marca registrada de seu respectivo proprietário. Este plugin não é afiliado à MultiSafepay nem endossado por ela.