VibeFox DPO for WooCommerce — Ajuda
Requisitos
WordPress: 6.2 ou superior.
WooCommerce: 8.0 ou superior, instalado e ativo. O plugin se recusa a ativar sem ele.
PHP: 8.0 ou superior.
Conta DPO Pay: você precisa do Company Token e do Service Type ID da sua conta de comerciante DPO. A DPO os emite quando sua conta é aberta; obtenha-os com o gerente da sua conta DPO ou em dpogroup.com. A DPO também pode fornecer uma conta de teste com seu próprio token e service type. Não há um servidor de teste separado: a DPO usa o mesmo endereço de API para contas de teste e de produção, e a conta é escolhida pelo token.
Moeda: a moeda da loja deve ser suportada pela sua conta DPO, por exemplo USD, EUR, ZAR, KES, UGX, TZS, RWF, GHS, NGN, ZMW, XOF ou AED. A DPO aceita no máximo 2 casas decimais, então totais de pedido com 3 casas decimais (por exemplo KWD 12.345) não podem ser pagos.
Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um domínio.
Instalação
1. No WordPress, vá para Plugins > Add New > Upload Plugin, escolha o arquivo ZIP do plugin e clique em Install Now. Você também pode enviar a pasta wcp_dpo_pay para /wp-content/plugins/ por FTP.
2. Clique em Activate.
3. Abra as configurações: WooCommerce > Settings > Payments > DPO Pay > Manage, ou clique em Settings sob o nome do plugin na página de plugins.
4. Digite sua chave de licença VibeFox no bloco de licença no topo da página e clique em Activate.
5. Digite o Company Token e o Service Type de teste e/ou de produção (veja Configuração).
6. Envie a URL de notificação push mostrada na página de configurações ao suporte da DPO e peça que a configurem para sua conta.
7. Ative Enable/Disable. Faça um pedido de teste no modo de teste e depois desmarque Test mode para aceitar pagamentos reais.
Configuração
Todas as configurações estão em uma única página: WooCommerce > Settings > Payments > DPO Pay. Quando o gateway está ativado mas o Company Token ou o Service Type do modo selecionado está vazio, a página avisa que o método de pagamento está oculto na finalização de compra, e salvar mostra o mesmo erro. Enquanto o modo de teste está ativo, a página mostra Test mode is on: payments are created with the test account credentials.
Geral
Enable/Disable: Enable DPO Pay 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: DPO Pay.
Description: o texto mostrado sob o método de pagamento na finalização de compra. Padrão: Pay securely by card or mobile money on the DPO Pay payment page.
Credenciais de API
A DPO emite um Company Token e um Service Type ID para sua conta de comerciante, e outros separados para uma conta de teste. Obtenha-os com o gerente da sua conta DPO ou em dpogroup.com.
Test mode: Use the test account credentials below. Quando ativado, novos pagamentos são criados com o Company Token e o Service Type de teste. Padrão: ativado. Desmarque para aceitar pagamentos reais com as credenciais de produção. As verificações de status de pedidos existentes sempre usam a conta com a qual o pagamento foi criado.
Test Company Token: o Company Token da sua conta de teste DPO.
Test Service Type: o Service Type ID numérico da sua conta de teste DPO.
Live Company Token: o Company Token da sua conta de comerciante DPO de produção.
Live Service Type: o Service Type ID numérico da sua conta de comerciante DPO de produção.
Um Service Type deve ser um número. Qualquer outro valor não é salvo: a página mostra um erro e mantém o valor anterior. Se você atualizar da versão 1.0, as credenciais dessa versão também são copiadas para os campos de teste.
Notificações de pagamento
A notificação push avisa sua loja imediatamente que um pagamento foi feito, mesmo que o cliente feche o navegador depois de pagar. Esta seção mostra a URL de notificação push. Ela se parece com https://your-site/wc-api/dpo_pay_notify/. Ela não é configurada em um painel: peça ao suporte da DPO para configurar essa URL para sua conta.
As notificações push da DPO não têm assinatura, então o conteúdo delas nunca é considerado confiável. O plugin só as usa para localizar o pedido e depois verifica o pagamento diretamente com a DPO. Sem a URL push, os pedidos ainda são confirmados quando o cliente retorna à loja e pelas novas verificações automáticas 15 minutos após o redirecionamento e após o limite de tempo de pagamento.
Pedidos
Successful payment status: o status do pedido após um pagamento aprovado verificado. O status é definido imediatamente, sem uma segunda alteração de status.
Avançado
Logging: Enable logging grava chamadas de API e notificações em WooCommerce > Status > Logs, origem wcp_dpo_pay. Erros sempre são registrados. Tokens são mascarados, nenhum dado do cliente é registrado. Padrão: desativado.
Delete data: Delete all plugin data when the plugin is deleted. Remove as configurações, os dados DPO armazenados nos pedidos e os logs ao desinstalar. A desativação nunca remove dados. Padrão: desativado.
Finalização de compra
O cliente escolhe o método de pagamento (padrão DPO Pay) e faz o pedido. O plugin cria uma transação DPO pelo valor total do pedido na moeda do pedido, com o número do pedido e o nome do seu site como descrição, e envia o cliente para a página de pagamento da DPO. Nome, e-mail, telefone e endereço do cliente são enviados para pré-preencher a página. Lá o cliente paga com qualquer método ativado na sua conta DPO. O link de pagamento é válido por 5 horas.
Depois de pagar, o cliente retorna à sua loja. O pedido só é marcado como pago depois que a DPO o confirma: o plugin consulta a DPO sobre o resultado da transação quando o cliente retorna, quando chega uma notificação push e nas verificações automáticas. Quando o pagamento é confirmado, o cliente vai para a página de pedido recebido.
Se o pagamento não for confirmado, o cliente volta para a finalização de compra ou para a página Pay for order com uma destas mensagens:
Se o cliente clicar no botão da página da DPO para voltar à loja, o pedido é cancelado da forma padrão do WooCommerce, e seu link de pagamento DPO é cancelado na DPO.
Quando um cliente paga novamente pelo mesmo pedido, o link de pagamento DPO anterior é verificado primeiro. Se foi pago, o pedido é concluído sem uma segunda cobrança. Se ainda estiver em processamento, o cliente vê Your previous payment for this order is still being processed by DPO. Please wait a few minutes before trying again. Caso contrário, o link antigo é cancelado na DPO e um novo é criado.
Se a DPO não puder iniciar o pagamento, o cliente vê uma mensagem curta escolhida pelo código de erro da DPO, por exemplo que o DPO Pay não suporta a moeda deste pedido, ou que o valor excede o limite permitido pelo DPO Pay, e pode escolher outro método de pagamento.
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 WooCommerce High-Performance Order Storage (HPOS).
O plugin aceita apenas pagamentos únicos na página da DPO. Não há reembolsos pelo WooCommerce, cartões salvos, assinaturas ou pagamentos recorrentes, campos de cartão no seu site nem captura de pagamentos apenas autorizados.
Pedidos
Status do pedido
Pending payment: o cliente foi enviado à DPO e ainda não pagou, ou a DPO ainda não confirmou o pagamento.
Processing, Completed ou On hold: o pagamento foi verificado. O status segue Successful payment status. A nota do pedido mostra o valor, a moeda, o código de aprovação e o início do token de transação DPO. O ID da transação é o token de transação DPO.
On hold after payment: a DPO confirmou um pagamento, mas o valor ou a moeda diferem do pedido, o pagamento está apenas autorizado e não capturado, a transação foi paga a mais ou a menos, ou o pedido já havia sido cancelado. A nota do pedido explica o motivo. Verifique a transação no portal da DPO. Capture ou anule um pagamento apenas autorizado no portal da DPO e depois atualize o pedido.
Failed: o pagamento foi recusado, cancelado ou o limite de tempo de pagamento expirou. O cliente pode pagar novamente.
Cancelled: o cliente voltou à loja a partir da página da DPO, ou o pedido foi cancelado por você ou pelo tempo limite do WooCommerce para pedidos não pagos. O link de pagamento DPO não pago é cancelado na DPO.
Uma mensagem posterior de recusa nunca altera um pedido já pago, e os resultados de links de pagamento antigos nunca fazem a tentativa atual falhar. Se a DPO confirmar um segundo pagamento aprovado para um pedido já pago, o pedido recebe uma nota sobre um possível pagamento duplicado, para que você possa reembolsá-lo no portal da DPO.
Reembolsos
Reembolsos pelo WooCommerce não estão disponíveis nesta versão. Reembolse o pagamento no portal de comerciante da DPO e depois marque o pedido como reembolsado no WooCommerce.
Chave de licença
O plugin funciona com uma chave de licença VibeFox de vibefox.net. O bloco de licença está no topo de WooCommerce > Settings > Payments > DPO Pay. 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 digitar outra chave e Remove key para removê-la deste site. O link Manage licenses and domains in your account abre sua conta vibefox.net.
Uma chave funciona em um domínio. Remover a chave de um site não libera sua vaga de domínio. Libere a vaga na sua conta vibefox.net.
Sem uma chave ativa, o DPO Pay não é exibido 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 de loja com login 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 de plugins e nas páginas do WooCommerce. Pedidos existentes não são afetados: pagamentos já iniciados ainda são confirmados.
Quando uma licença expira, o plugin continua funcionando, mas atualizações e suporte exigem uma renovação. O status é verificado novamente de forma automática em segundo plano.
Solução de problemas
O DPO Pay não aparece na finalização de compra: verifique se a licença está ativa, Enable/Disable está ativado e o Company Token e o Service Type do modo selecionado estão definidos: os campos de teste no modo de teste, os campos de produção caso contrário. A página de configurações mostra um aviso quando estão faltando.
O pagamento foi efetuado, mas o pedido permanece em Pending payment: provavelmente a URL de notificação push não está configurada para sua conta DPO, e o cliente não retornou à loja. Peça ao suporte da DPO para configurar a URL mostrada nas configurações. O pedido também é confirmado pela verificação automática 15 minutos após o redirecionamento. Ative Logging e veja WooCommerce > Status > Logs, origem wcp_dpo_pay.
A notificação push responde Unknown transaction: o token de transação não pertence a um pedido DPO Pay desta loja, por exemplo a notificação veio de outra loja na mesma conta DPO.
A notificação push responde Verification failed: não foi possível contatar a DPO para verificar o pagamento. A DPO repete a notificação, e a verificação automática também confirma o pedido.
O Service Type não é salvo: ele deve ser o Service Type ID numérico da DPO.
O cliente vê DPO Pay is temporarily unavailable: a DPO se recusou a criar a transação, por exemplo devido a um Company Token ou Service Type incorreto, ou um token do outro modo. O código de resultado da DPO está em WooCommerce > Status > Logs, origem wcp_dpo_pay.
O cliente vê que a DPO aceita no máximo 2 casas decimais: o total do pedido tem 3 casas decimais. A DPO não pode cobrar esses valores.
O pedido fica Aguardando após o pagamento: leia a nota do pedido. O valor ou a moeda pagos diferiam do pedido, o pagamento está apenas autorizado, a transação foi paga a mais ou a menos, ou o pedido havia sido cancelado. Verifique a transação no portal da DPO.
O bloco de licença mostra um erro: siga a mensagem no bloco. Por exemplo, se a chave já está em uso em outro domínio, libere uma vaga na sua conta 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 contatado, o plugin continua funcionando com o último status conhecido.
Desinstalação
Desativar o plugin mantém todos os dados e apenas interrompe as verificações de status agendadas. 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, os dados DPO armazenados nos pedidos, as verificações agendadas e os logs são removidos somente se Delete data estava ativado. Caso contrário, permanecem para uma futura reinstalação. Pedidos existentes mantêm suas notas de pagamento e IDs de transação.
DPO Pay é uma marca registrada de seu respectivo proprietário. Este plugin não é afiliado nem endossado pela DPO Pay.