Plugins de e-commerce
WISECP Gateway
Instale e configure o gateway WISECP oficial para checkout hospedado MakePay em hospedagem e faturas de serviço.
Gateway MakePay para WISECP
O gateway MakePay oficial para WISECP permite que os clientes paguem faturas por meio da criptografia hospedada checkout. WISECP mantém o controle de clientes, faturas, serviços, renovações e provisionamento. MakePay cria o link checkout e envia atualizações de pagamento de volta ao WISECP.
Isto é útil para provedores de hospedagem, equipes de SaaS, agências e empresas de serviços que já faturam com WISECP.
Antes de começar
Você precisa de:
- WISECP 3.1.7 ou superior
- Instalação WISECP HTTPS
- Acesso de administrador às configurações do gateway de pagamento WISECP
- Liquidação e flag MakePay configuradas
Instale o gateway
Baixe o pacote mais recente:
https://plugins.makecrypto.io/downloads/wisecp/latest.zip
Extraia o ZIP e carregue a pasta MakePay para:
WISECP/coremio/modules/Payment/MakePay
No WISECP, abra Configurações > Faturamento > Gateways de Pagamento, pesquise MakePay, habilite-o e salve as configurações do módulo.
Conecte MakePay
Abra as configurações do gateway MakePay no WISECP e use o link Conectar MakePay exibido no campo de status da conexão.
O fluxo de conexão:
- Abra a página de conexão MakePay.
- Permite escolher a empresa que receberá os pagamentos.
- Devolve você ao WISECP após aprovação.
- Salve a conexão do gateway para esta instalação do WISECP.
Após a conexão, crie uma pequena fatura de teste e pague na área do cliente.
Alternativa com chave manual API
Conectar MakePay é a configuração recomendada. A configuração manual da chave API está disponível para instalações que não podem concluir a conexão guiada.
Para configuração manual, defina o método de conexão como api_key e insira:
- ID da empresa MakePay
- ID da chave API
- Segredo da chave API
- Segredo de assinatura webhook
Mantenha o retorno de chamada URL gerado pelo WISECP acessível na Internet pública.
Fluxo checkout
Quando um cliente escolhe MakePay para uma fatura WISECP, o gateway:
- Lê o ID checkout, o valor da fatura e a moeda do WISECP.
- Crie um link de pagamento hospedado MakePay.
- Exibe um botão Pagar com MakePay.
- Envia o cliente para o checkout hospedado.
- Receba um retorno de chamada assinado quando o status do pagamento mudar.
O link de pagamento inclui metadados como:
| Campo | Propósito |
|---|---|
source=wisecp | Identifique a integração |
checkoutId | Mapeia a atividade MakePay de volta para checkout WISECP |
orderId | Use o ID WISECP checkout para pesquisa de retorno de chamada |
Status da fatura
| Estado MakePay | Comportamento WISECP |
|---|---|
paid, completed, confirmed, succeeded | Marcar checkout como bem-sucedido |
pending, waiting, confirming | Mantém checkout pendente |
failed, expired, cancelled | Marcar checkout como erro |
A WISECP permanece responsável pela ativação do serviço, renovações, numeração de faturas e notificações ao cliente após o pagamento da fatura.
Notas de segurança
Use HTTPS, limite o acesso do administrador WISECP e desconecte o gateway do painel MakePay se uma conta de administrador ou backup do servidor for exposta. Reconecte após alterar o domínio WISECP para que os URLs de retorno e retorno correspondam à instalação ao vivo.
Solução de problemas
Se Connect MakePay falhar ao iniciar, confirme se o gateway está instalado em coremio/modules/Payment/MakePay e se o retorno de chamada WISECP URL é público.
Se as faturas não forem atualizadas, verifique se o segredo de assinatura webhook está presente e se o seu servidor pode receber retornos de chamada HTTPS de MakePay.
Se os clientes virem um erro checkout, confirme se MakePay está conectado e se a moeda da fatura selecionada é compatível com sua configuração MakePay.