VibeFox CorvusPay for WooCommerce — Ajuda

Requisitos

WordPress: 6.0 ou superior.

WooCommerce: 7.0 ou superior, instalado e ativo. O plugin se recusa a ativar sem ele.

PHP: 8.0 ou superior.

Moeda: AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK ou USD. Em qualquer outra moeda, o método de pagamento fica oculto na finalização de compra. Os valores são enviados com 2 casas decimais; um total com mais casas decimais (por exemplo, em uma loja BHD com 3 casas decimais) é recusado em vez de ser arredondado.

Conta CorvusPay: você precisa de uma conta de comerciante na CorvusPay. A CorvusPay emite um Store ID e uma Secret Key para cada loja, separadamente para a loja de teste e a de produção; eles são exibidos no CorvusPay Merchant Center. A Success URL e a Cancel URL do plugin precisam ser cadastradas lá (veja Configuração).

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

2. Clique em Activate.

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

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

5. Digite o Store ID e a Secret Key da sua loja de teste na CorvusPay (e da loja de produção, para pagamentos reais). Copie a Success URL e a Cancel URL exibidas na página de configurações para o CorvusPay Merchant Center, para a loja de teste e a de produção.

6. Ative Enable/Disable, faça um pedido de teste e depois desmarque Test Mode para entrar em produção.

Configuração

Todas as configurações ficam em uma única página: WooCommerce > Settings > Payments > CorvusPay. Acima dos campos, a página mostra Test mode is on. enquanto o modo de teste está ativo, e avisa quando o gateway está ativado mas o Store ID ou a Secret Key do modo atual está vazio (ele fica oculto na finalização de compra até que sejam preenchidos) e quando a moeda da loja não é compatível com a CorvusPay.

Geral

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

Title: o nome do método de pagamento que os clientes veem na finalização de compra. Padrão: Credit/Debit Card (CorvusPay).

Description: o texto exibido abaixo do método de pagamento na finalização de compra. Padrão: Pay securely with your credit or debit card via CorvusPay. No modo de teste, (Test mode — no real payment is taken.) é adicionado a ele.

Credenciais da loja

O Store ID e a Secret Key são emitidos pela CorvusPay para cada loja (teste e produção separadamente) e são exibidos no CorvusPay Merchant Center.

Test Mode: Enable test mode usa o ambiente de teste da CorvusPay (wallet.test.corvuspay.com) e o Store ID e a Secret Key de teste. Padrão: ativado.

Test Store ID: o Store ID numérico da sua loja de teste na CorvusPay.

Test Secret Key: a Secret Key da sua loja de teste na CorvusPay, usada para as assinaturas HMAC-SHA256.

Live Store ID: o Store ID numérico da sua loja de produção na CorvusPay.

Live Secret Key: a Secret Key da sua loja de produção na CorvusPay, usada para as assinaturas HMAC-SHA256.

Um Store ID deve conter apenas dígitos. Se você digitar qualquer outra coisa, um erro é exibido e o valor anterior é mantido. Um pagamento é sempre verificado com a Secret Key da loja em que foi feito, então mantenha a chave de teste preenchida enquanto ainda houver pedidos de teste em aberto.

Success URL e Cancel URL

Copie os dois endereços exibidos nesta seção para o CorvusPay Merchant Center, para a loja de teste e a de produção. A CorvusPay devolve o cliente a eles após o pagamento.

Pagamento

Transaction Type: como o cartão é cobrado.

Payment Page Language: o idioma da página de pagamento da CorvusPay. Site language (padrão) usa o idioma atual do seu site quando a CorvusPay o oferece; caso contrário, inglês. Você também pode escolher croata, inglês, alemão, italiano, sérvio ou esloveno.

Order Status After Payment: o status do pedido após um pagamento Sale bem-sucedido. O status é definido de imediato, sem uma segunda mudança de status.

Avançado

Logging: Enable debug logging grava em WooCommerce > Status > Logs, origem wcp_corvuspay_gateway. Os erros são sempre registrados; segredos e dados do cliente, nunca. Padrão: desativado.

Delete Data: Delete the plugin settings and log files when the plugin is deleted (uninstalled). A desativação nunca exclui nada. Os dados de pagamento armazenados nos pedidos são sempre mantidos. Padrão: desativado.

Finalização de compra

O cliente escolhe o método de pagamento (por padrão, Credit/Debit Card (CorvusPay)) e faz o pedido. O pedido permanece em Pagamento pendente, e a página Pay for order exibe Redirecting to CorvusPay for payment. Please wait... e envia o formulário assinado para a página de pagamento da CorvusPay. Se o redirecionamento não iniciar, o cliente clica em Pay via CorvusPay. São enviados o total do pedido, a moeda, uma breve descrição do carrinho e os dados de cobrança (para preencher previamente a página de pagamento). O mesmo número de pedido da CorvusPay é reutilizado enquanto o valor não muda, e a CorvusPay não aceita um segundo pagamento para ele.

Depois de pagar, a CorvusPay devolve o cliente à Success URL. O pedido só é marcado como pago depois que a CorvusPay confirma: o número de pedido da CorvusPay deve ter sido emitido para este pedido, a assinatura deve corresponder à Secret Key da loja em que o pagamento foi feito, e o valor e a moeda devem coincidir com o pedido. Em seguida, o cliente chega à página de pedido recebido. O estoque é reduzido quando o pagamento é confirmado, e o carrinho é esvaziado na página de pedido recebido.

Se o cliente cancela na página da CorvusPay, o pedido não pago é cancelado e o cliente volta à finalização de compra com o carrinho intacto e The CorvusPay payment was cancelled and the order was not paid. Your cart is still here — you can try again or choose another payment method. Se o pagamento foi iniciado pela página Pay for order e o carrinho está vazio, o WooCommerce exibe The CorvusPay payment was cancelled and the order was not paid. na página do carrinho. Se a requisição à Success URL não puder ser verificada, o cliente vê We could not confirm this CorvusPay payment. If your card was charged, please contact the shop — do not pay again. e o pedido não é alterado.

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. Ele é compatível com o armazenamento de pedidos de alto desempenho (HPOS) do WooCommerce. Os textos estão traduzidos para o croata.

O pedido só é confirmado quando a CorvusPay devolve o cliente à Success URL; não há notificações de servidor para servidor. Se o cliente fechar o navegador logo após pagar, o pedido permanece em Pagamento pendente. O plugin não tem reembolsos, capturas nem anulações pelo WooCommerce (a API de servidor da CorvusPay exige um certificado de cliente), nem cartões salvos, assinaturas, parcelamento, IBAN / PIS ou CorvusWallet.

Pedidos

Status dos pedidos

Pending payment: o cliente foi enviado à CorvusPay e ainda não voltou. Se o cliente pagou mas não voltou, verifique o pagamento no CorvusPay Merchant Center e conclua o pedido manualmente.

Processing, Completed ou On Hold: o pagamento Sale foi confirmado. O status segue Order Status After Payment. A nota do pedido mostra o número de pedido da CorvusPay, o código de aprovação e o tipo de cartão. O ID de transação do pedido é o ID de transação da CorvusPay ou, se a CorvusPay não enviar um, o número de pedido da CorvusPay, pelo qual o pagamento pode ser encontrado no Merchant Center.

On hold, autorizado: Authorize only está selecionado. Capture o pagamento no CorvusPay Merchant Center e depois altere o pedido para Processando.

On hold, divergência de valor/moeda: o valor ou a moeda pagos não coincidem com o pedido. Não envie antes de verificar o pagamento no CorvusPay Merchant Center.

On hold, pagamento de um pedido cancelado: um pagamento bem-sucedido chegou depois que o pedido havia sido cancelado, por exemplo pelo tempo limite de pedidos não pagos. Atenda o pedido ou reembolse o pagamento no CorvusPay Merchant Center.

Cancelled: o cliente cancelou o pagamento na página da CorvusPay.

Se outro pagamento bem-sucedido, diferente, chegar para um pedido que já está pago ou encerrado, o pedido não é alterado. Uma nota pede que você verifique o CorvusPay Merchant Center e reembolse o pagamento duplicado, se necessário.

Refunds: reembolsos, capturas e anulações pelo WooCommerce não são compatíveis. Faça-os no CorvusPay Merchant Center e registre o reembolso manualmente no WooCommerce.

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 > CorvusPay. 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 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 CorvusPay não é exibida 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. Os gerentes da loja conectados ainda veem o método de pagamento, marcado com (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: clientes que voltam de pagamentos já iniciados continuam sendo processados.

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 CorvusPay não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ativado, se o Store ID e a Secret Key do modo atual estão preenchidos (Test Store ID e Test Secret Key no modo de teste, Live Store ID e Live Secret Key no modo de produção) e se a moeda da loja é compatível com a CorvusPay. A página de configurações mostra um aviso em cada caso.

O pagamento foi concluído, mas o pedido permanece em Pagamento pendente: provavelmente a Success URL não está cadastrada no CorvusPay Merchant Center, ou a Secret Key no WooCommerce não corresponde à loja. Ative Logging e procure INVALID signature em WooCommerce > Status > Logs, origem wcp_corvuspay_gateway. O pedido também permanece pendente se o cliente fechou o navegador antes de voltar; nesse caso, verifique o pagamento no Merchant Center e conclua o pedido manualmente.

O cliente vê We could not confirm this CorvusPay payment: a requisição à Success URL foi rejeitada: faltavam campos obrigatórios, o número de pedido da CorvusPay não foi emitido para o pedido, a Secret Key dessa loja está vazia ou a assinatura não coincidiu. O pedido não é alterado. O log mostra o motivo.

O cliente vê This order total cannot be paid via CorvusPay: o total é zero ou tem mais de 2 casas decimais.

O cliente vê CorvusPay is not configured ou CorvusPay does not accept payments in …: falta o Store ID ou a Secret Key do modo atual, ou a moeda do pedido não é compatível.

O pedido está On hold: leia a nota do pedido. Authorize only está selecionado, o valor ou a moeda pagos não coincidiam com o pedido, ou o pagamento chegou depois que o pedido foi cancelado.

O bloco de licença mostra um erro: siga a mensagem do bloco. Por exemplo, se a chave já está 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 para o 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 e os arquivos de log só são removidos se Delete Data estava ativado. Caso contrário, eles permanecem para uma reinstalação posterior. Os dados de pagamento armazenados nos pedidos são sempre mantidos. Os pedidos existentes mantêm suas notas de pagamento e IDs de transação.

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