Módulo MakePay para Magento

Resumo

O módulo MakePay oficial para Magento adiciona um método de criptografia hospedado checkout às lojas Magento Open Source e Adobe Commerce 2.4.x. Magento cria o pedido, MakePay cria o link de pagamento hospedado e o webhooks assinado atualiza o pedido quando o status do pagamento muda.

Use Conecte MakePay para configuração normal. Credenciais manuais com chave API ainda estão disponíveis como alternativa.

Antes de começar

• Magento Open Source ou Adobe Commerce 2.4.x
• PHP 8.1 ou superior
• Acesso de administrador a Lojas > Configuração > Vendas > Métodos de Pagamento
• Uma empresa MakePay onde você pode gerenciar ajustes de pagamento

Instale o módulo

Baixe o ZIP mais recente:

https://plugins.makecrypto.io/downloads/magento/latest.zip

Extraia o pacote para que o módulo fique localizado em:

app/code/MakePay/Payment

Habilite-o na raiz do Magento:

bin/magento module:enable MakePay_Payment
bin/magento setup:upgrade
bin/magento cache:clean

Conecte MakePay

Abra Lojas > Configuração > Vendas > Métodos de Pagamento > MakePay e selecione Conectar MakePay. O módulo:

1. Abra MakeCrypto em uma guia do navegador.
2. Ele pede que você faça login e escolha a empresa que receberá os pagamentos.
3. Mostra as permissões que o módulo Magento necessita.
4. Retorna você ao Magento após a aprovação.
5. Salve a conexão da loja na configuração criptografada do Magento.
6. Configura o retorno de chamada webhook MakePay e o segredo webhook.

Configurar MakePay

Após a conexão, ele mantém o Método de Conexão no modo conectado padrão. Habilite a forma de pagamento e verifique:

• Nome da forma de pagamento
• Experiência de check-out
• Moeda de liquidação
• Expiração do link de pagamento
• Status de pedidos pendentes, pagos, com falha, cancelados e reembolsados

O fallback manual requer o ID da empresa MakePay, o ID da chave API, o segredo da chave API e o segredo webhook.

Fluxo checkout

Quando um cliente escolhe MakePay, Magento coloca o pedido com pagamento pendente e então abre a experiência checkout MakePay selecionada. O redirecionamento hospedado é a opção recomendada; O checkout incorporado exibe uma página segura com iframe MakePay e um link de fallback hospedado.

A carga útil do link de pagamento inclui:

Campo	Propósito
source=magento	Identifique a integração
orderId=magento_order_<id>	Mapeie a atividade MakePay de volta para Magento
incrementId	Número de pedido Magento legível
magentoOrderAdminUrl	Permite que MakeCrypto vincule administradores ao pedido Magento
moduleVersion	Versão instalada do módulo MakePay
magentoVersion	Versão runtime do Magento ou Adobe Commerce

Status do pedido

O ponto final de webhook é /makepay/webhook/index. Verifique o cabeçalho X-MakePay-Signature antes de atualizar um pedido.

Estado MakePay	Status do Magento
paid, completed, confirmed, succeeded	Processamento
failed, expired	Cancelado
cancelled, canceled	Cancelado
refunded	Fechado
Outros estados	Pagamento pendente

Cada webhook grava um comentário privado no histórico de pedidos com status de pagamento, URL público, checkout MakePay, painel URL MakeCrypto e identificadores MakePay disponíveis.

Notas de segurança

O módulo salva detalhes da conexão nas configurações criptografadas do Magento. Limite o acesso de administrador do Magento a operadores confiáveis ​​e coloque a loja offline em MakeCrypto se uma conta de administrador ou backup de servidor for exposto.

A conexão solicita estas permissões:

• company:read
• makepay:payment-links:read
• makepay:payment-links:write
• makepay:customers:read
• makepay:customers:write
• makepay:settings:read
• makepay:settings:write

Solução de problemas

Se Connect MakePay falhar ao iniciar, confirme se a base Magento URL é HTTPS e acessível publicamente. Se os redirecionamentos checkout falharem, confirme se o módulo está habilitado e se MakePay tem uma conexão salva ou credenciais manuais válidas. Caso os pedidos não sejam atualizados, compare o callback URL de webhook nas configurações MakePay com o URL Magento /makepay/webhook/index e gire o segredo de webhook.