Plugins de e-commerce
Plug-in VirtueMart
Instale e configure o plugin oficial VirtueMart para checkout hospedado MakePay em lojas Joomla.
Plug-in MakePay para VirtueMart
Resumo
O plugin MakePay para VirtueMart adiciona um método de pagamento criptográfico hospedado para lojas Joomla usando VirtueMart. Os clientes escolhem MakePay em checkout, pagam na página checkout MakePay e retornam à loja enquanto o VirtueMart retém o registro do pedido.
As notificações de pagamento assinadas atualizam o pedido do VirtueMart após o pagamento, para que a equipe da loja possa continuar gerenciando os pedidos no VirtueMart.
Antes de começar
- Joomla com VirtueMart instalado
- PHP 7.4 ou superior com OpenSSL e cURL habilitados
- URL vitrine HTTPS pública
- Acesso à instalação de extensões Joomla e métodos de pagamento VirtueMart
- Uma empresa MakePay com liquidação e marca configurada
Instale o plug-in
Baixe o ZIP mais recente:
https://plugins.makecrypto.io/downloads/virtuemart/latest.zip
No Joomla, abra Sistema > Extensões, carregue o ZIP e ative VM Payment - MakePay Crypto Payment Gateway no gerenciador de plugins.
No VirtueMart, abra Métodos de pagamento, crie um método de pagamento, escolha o plugin de pagamento MakePay e salve-o uma vez para que o VirtueMart atribua um ID do método de pagamento.
Conecte MakePay
Após salvar a forma de pagamento, abra o login URL na vitrine. Substitua PAYMENT_METHOD_ID pelo ID do método de pagamento VirtueMart:
https://store.example.com/index.php?option=com_virtuemart&view=pluginresponse&task=pluginnotification&tmpl=component&makepay_oauth=connect&pm=PAYMENT_METHOD_ID
MakePay solicita que você faça login, escolha a empresa que receberá os pagamentos e aprove a conexão. Após a aprovação, o plugin salva a conexão com esse método de pagamento VirtueMart e define o retorno de chamada MakePay URL.
Configuração do gateway
Revise estes campos antes de ativar publicamente a forma de pagamento:
| Ajuste | Propósito |
|---|---|
| Método de conexão | Use Connect MakePay para configuração normal ou chaves manuais API como alternativa |
| ID da empresa MakePay | Preenchido após a conexão ou inserido manualmente para fallback |
| Moeda de liquidação | Ativo de liquidação preferencial, como USDT |
| Expiração do pagamento | Por quanto tempo o link checkout hospedado permanece pagável? |
| Segredo de webhook | Usado para verificar notificações de pagamento MakePay |
| Status do pedido | VirtueMart declara para pagamentos pendentes, pagos, com falha, expirados, cancelados e reembolsados |
Fluxo checkout
Quando um comprador seleciona MakePay, o plugin cria um link de pagamento MakePay com:
| Campo | Propósito |
|---|---|
source=virtuemart | Identifique a integração |
orderId=virtuemart_order_<id> | Mapeia a atividade MakePay de volta ao VirtueMart |
orderNumber | Número do pedido VirtueMart mostrado ao comerciante |
pluginVersion | Versão instalada do plugin MakePay |
virtuemartVersion | Versão de tempo de execução do VirtueMart quando disponível |
O comprador é redirecionado para o checkout hospedado. MakePay então envia uma notificação assinada para o endpoint de notificação do plug-in VirtueMart.
Status do pedido
| Estado MakePay | Comportamento do VirtueMart |
|---|---|
paid, completed, confirmed, succeeded | Mova o pedido para o status pago configurado |
expired | Mova o pedido para o estado expirado configurado |
failed | Mova o pedido para o estado de falha configurado |
cancelled, canceled | Mova o pedido para o estado cancelado configurado |
refunded | Mover o pedido para o status reembolsado configurado |
| Outros estados | Eles são ignorados até que chegue um status de pagamento final |
Cada atualização grava um comentário de pedido privado com a transação MakePay, valor, ativo e pagamento URL quando esses campos estão presentes.
Alternativa com chave manual API
Se o fluxo de conexão não puder ser usado, defina Método de conexão como Chave alternativa API manual e insira:
- ID da empresa MakePay
- ID da chave API
- Segredo da chave API
- Segredo de webhook
Use-o somente quando necessário e limite o acesso do administrador do Joomla a operadores confiáveis.
Solução de problemas
Se checkout não puder ser iniciado, confirme se o método de pagamento possui uma conexão de empresa ou configurações manuais de chave API. Se a conexão URL falhar, confirme se a vitrine é HTTPS pública e se o valor pm aponta para a forma de pagamento salva MakePay.
Se os pedidos não forem atualizados, compare o retorno de chamada URL MakePay com a notificação URL do plugin VirtueMart e gire o segredo de webhook nas configurações do método de pagamento.