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

Conta de comerciante no iPay88: o Merchant Code e a Merchant Key são emitidos pelo iPay88 quando a sua conta de comerciante é ativada. Eles também aparecem no portal do comerciante do iPay88. Se você ainda não é comerciante, faça o cadastro no site do iPay88. Mantenha a Merchant Key em sigilo: ela assina os pagamentos.

Request URL: o endereço do seu site precisa estar cadastrado no iPay88 como Request URL. Caso contrário, a página do iPay88 mostra "Permission not allow".

Moeda da loja: Malaysia — MYR, e USD, SGD, AUD, CAD, EUR, GBP, HKD, CNY, TWD, INR, IDR, PHP ou THB, se a opção de multimoeda estiver ativada na sua conta do iPay88; Philippines — PHP ou USD; Indonesia — IDR; Thailand — THB.

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

2. Clique em Activate.

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

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

5. Escolha sua iPay88 region e informe o Merchant Code e a Merchant Key (veja Configuração).

6. Ative Enable/Disable. Para testar a configuração, faça um pagamento com o Test mode ativado e depois desative o modo de teste.

Configuração

Todas as configurações ficam em uma única página: WooCommerce > Settings > Payments > iPay88. Acima dos campos, a página avisa quando o Merchant Code ou a Merchant Key está faltando (nesse caso, o método de pagamento não aparece na finalização de compra), quando a moeda da loja não pode ser cobrada na região selecionada e enquanto o modo de teste estiver ativado. Na lista de métodos de pagamento, o iPay88 aparece como pendente de configuração até que as duas chaves sejam informadas, e exibe um selo de modo de teste enquanto ele estiver ativo.

Geral

Enable/Disable: Enable iPay88 Payment Gateway liga ou desliga o método de pagamento. Padrão: desativado.

Title: o nome do método de pagamento que o cliente vê na finalização de compra. Padrão: iPay88.

Description: o texto exibido abaixo do método de pagamento na finalização de compra. Padrão: Pay securely via iPay88 (credit card, online banking, e-wallet).

Conta do iPay88

iPay88 region: o país da sua conta de comerciante no iPay88. Ela define a página de pagamento do iPay88 e as moedas que podem ser cobradas. O pedido é sempre cobrado na própria moeda. Padrão: Malaysia.

Merchant Code: o seu Merchant Code do iPay88, por exemplo M01234.

Merchant Key: a sua Merchant Key do iPay88. Ela assina as solicitações de pagamento e verifica as respostas do iPay88. Mantenha-a em sigilo.

Signature type: como as solicitações de pagamento são assinadas. As respostas são verificadas nos dois formatos.

Pagamento

Payment method: pré-selecione um método de pagamento do iPay88 na lista PaymentId da Malásia, ou deixe Let the customer choose on the iPay88 page (padrão). A lista inclui Credit Card (MYR), FPX (Online Banking), Maybank2U, Alliance Online, AmBank, RHB Bank, Hong Leong Bank, CIMB Clicks, Web Cash, PayPal (MYR), Credit Card (PHP), Boost, Touch n Go eWallet, GrabPay e ShopeePay.

Reference prefix: opcional. É adicionado antes do número do pedido na referência do iPay88 (RefNo), por exemplo SHOP1-. Use um prefixo diferente em cada loja que usa a mesma conta do iPay88, para que a resposta de uma loja nunca seja aplicada a um pedido de outra. Letras, dígitos, "-" e "_", até 10 caracteres. Um prefixo que termina em dígito é corrigido ao salvar, porque o número do pedido é lido a partir do fim da referência.

Test mode: Charge a fixed test amount instead of the order total. O iPay88 não tem sandbox separado: os pagamentos de teste são transações reais na página ativa do iPay88, com um valor pequeno (1,00; IDR 10.000). O pedido é marcado como pago quando o valor de teste é recebido, e a nota do pedido informa isso. Enquanto o modo de teste estiver ativado, a finalização de compra mostra TEST MODE: only a test amount of ... will be charged. Nunca deixe o modo de teste ativado em uma loja em produção. Padrão: desativado.

URLs de resposta e de backend

O plugin envia as duas URLs em cada pagamento, então não há nada a configurar. Se o iPay88 pedir, copie-as desta seção das configurações. Elas têm este formato: https://your-site/wc-api/ipay88_p_response/ (Response URL, o retorno do cliente) e https://your-site/wc-api/ipay88_p_backend/ (Backend URL, a notificação de servidor para servidor). A seção também mostra o endereço do seu site, que precisa estar cadastrado no iPay88 como Request URL.

As duas respostas do iPay88 são verificadas da mesma forma: a assinatura feita com a sua Merchant Key, a referência de um pagamento que esta loja iniciou para este pedido, o valor e a moeda. Solicitações sem assinatura válida são rejeitadas e nunca alteram um pedido. A notificação de backend recebe RECEIVEOK somente depois de processada; caso contrário, o iPay88 a envia novamente. O iPay88 informa estes status de pagamento:

Avançado

Debug log: Log payment requests and iPay88 responses em WooCommerce > Status > Logs, origem wcp_ipay88_payment, sem dados pessoais nem assinaturas. Os erros são sempre registrados. Padrão: desativado.

Delete data on uninstall: Delete the settings, logs and iPay88 order data when the plugin is deleted. Os pedidos em si nunca são excluídos. Padrão: desativado.

Finalização de compra

O cliente escolhe o método de pagamento (por padrão, iPay88) e faz o pedido. O pedido permanece em Pending payment, e o cliente vê Redirecting to iPay88 payment gateway... enquanto um formulário é enviado à página de pagamento do iPay88 da sua região. Sem JavaScript, o cliente clica em Pay Now. Os itens do pedido, o nome, o e-mail e o telefone do cliente são transmitidos ao iPay88. Na página do iPay88, o cliente paga com cartão, FPX (internet banking), carteira eletrônica ou outro método oferecido pela sua conta.

Depois de pagar, o cliente volta à página de pedido recebido da sua loja. O pedido só é marcado como pago quando o iPay88 confirma com uma resposta assinada, seja no retorno do cliente ou pela notificação de backend. Se a confirmação ainda não tiver chegado, a página mostra We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly. Para um pagamento pendente, ela mostra Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed.

Se o pagamento foi recusado ou cancelado, o cliente cai na página Pay for order com The payment was not completed: e o motivo informado pelo iPay88, e pode pagar novamente ou escolher outro método de pagamento. Se a resposta não puder ser verificada, o cliente vê The payment response could not be verified. If you completed the payment, please contact us with your order number — the payment will be checked manually. com um link de volta para a loja.

O estoque é reduzido quando o pagamento é confirmado, e não quando o cliente é redirecionado. 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. Não há reembolsos pelo WooCommerce, cartões salvos, assinaturas, pré-autorização e captura, nem campos de cartão no seu site. Ele não consulta o iPay88 novamente sobre o status do pagamento: os pedidos são atualizados apenas pela resposta do iPay88 e pela notificação de backend. A API 2.0 do iPay88 Indonesia (JSON / link de pagamento) não é usada.

Pedidos

Order statuses

Pending payment: o cliente foi enviado ao iPay88 e ainda não pagou, ou o iPay88 ainda não confirmou o pagamento.

Processing or Completed: o pagamento foi confirmado. O WooCommerce define o status usual de um pedido pago. A nota do pedido mostra o TransID, o PaymentID, o valor e a moeda do iPay88. O ID da transação é o TransID do iPay88. No modo de teste, uma segunda nota informa que o valor de teste foi cobrado no lugar do total do pedido.

On hold, pending at iPay88: o iPay88 informou que o pagamento está pendente. O pedido será atualizado quando o iPay88 confirmar ou recusar o pagamento.

On hold, for review: o iPay88 informou um pagamento bem-sucedido com valor ou moeda diferentes do pedido, ou o pagamento chegou depois que o pedido foi cancelado. O pedido não foi marcado como pago. A nota do pedido explica isso. Verifique o pagamento no portal do iPay88 e então atenda o pedido ou reembolse o pagamento.

Failed: o pagamento foi recusado ou cancelado. A nota mostra o motivo informado pelo iPay88. O cliente pode pagar novamente.

Se chegar outro pagamento bem-sucedido para um pedido que já está pago ou reembolsado, o pedido não é alterado. Uma nota pede que você verifique no portal do iPay88 e reembolse caso seja uma duplicidade. Uma resposta de falha nunca altera um pedido pago, reembolsado ou cancelado.

Reembolsos

Os reembolsos não são enviados ao iPay88 pelo WooCommerce. Reembolse o pagamento no portal do comerciante do iPay88 e registre o reembolso manualmente 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 > iPay88. 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, o iPay88 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. Os gerentes da loja que estiverem 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 de Plugins e nas páginas do WooCommerce. Os pedidos existentes não são afetados: os pagamentos já iniciados continuam sendo confirmados.

Quando uma licença expira, o plugin continua funcionando, mas atualizações e suporte exigem renovação. O status é verificado de novo automaticamente em segundo plano.

Solução de problemas

O iPay88 não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ligado, se o Merchant Code e a Merchant Key foram informados e se a moeda da loja pode ser cobrada na iPay88 region selecionada. A página de configurações mostra um aviso quando algo está faltando.

O pagamento foi feito, mas o pedido continua em Pending payment: nem o retorno do cliente nem a notificação de backend chegaram à sua loja com uma assinatura válida. Ative o Debug log e veja WooCommerce > Status > Logs, origem wcp_ipay88_payment. Confirme que a Merchant Key é exatamente a que o iPay88 forneceu e que o seu site consegue receber requisições do iPay88 na Backend URL mostrada nas configurações.

A página do iPay88 mostra "Permission not allow": o endereço do seu site não está cadastrado no iPay88 como Request URL. Peça ao iPay88 para cadastrar o endereço mostrado na seção Response and backend URLs.

A notificação de backend responde BAD SIGNATURE: a assinatura não corresponde à Merchant Key. Verifique a Merchant Key.

A notificação de backend responde NOT CONFIGURED: o Merchant Code ou a Merchant Key não estão definidos, então a resposta não pode ser verificada. O iPay88 envia a notificação novamente.

A notificação de backend responde UNKNOWN ORDER: nenhum pagamento do iPay88 foi iniciado para esta referência nesta loja, por exemplo porque outra loja com a mesma conta não usa um Reference prefix ou usa o mesmo.

O pedido está On hold com uma nota sobre valor ou moeda: o iPay88 informou um pagamento que não corresponde ao pedido, ou o pedido tinha sido cancelado. O pedido não foi marcado como pago. Verifique o pagamento no portal do iPay88 e conclua-o ou reembolse-o.

O cliente vê "iPay88 cannot accept payments in" e uma moeda: a moeda do pedido não pode ser cobrada na região selecionada. No iPay88 Malaysia, moedas diferentes de MYR também exigem a opção de multimoeda na sua conta do iPay88.

Clientes reais são cobrados apenas 1,00: o Test mode está ativado. Desative-o.

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.

Desenvolvedores podem alterar a URL da página de pagamento, as moedas, as casas decimais, o valor de teste e o ícone com os filtros ipay88_p_payment_url, ipay88_p_supported_currencies, ipay88_p_currency_decimals, ipay88_p_test_amount e ipay88_p_icon.

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, os registros e os dados do iPay88 armazenados nos pedidos são removidos somente se Delete data on uninstall estiver ativado. Caso contrário, eles são mantidos para uma reinstalação posterior. Os pedidos em si nunca são excluídos e mantêm suas notas de pagamento e IDs de transação.

O iPay88 é uma marca registrada de seu respectivo proprietário. Este plugin não é afiliado nem endossado pelo iPay88.