Plugins de e-commerce
Portal de Blesta
Instale e configure o gateway oficial Blesta para checkout hospedado MakePay em faturas de clientes.
Gateway MakePay para Blesta
O gateway oficial MakePay para Blesta permite que os clientes paguem faturas Blesta usando a criptografia hospedada checkout. Blesta cria e controla a fatura. MakePay cria o link checkout e envia atualizações de pagamento de volta para Blesta.
O faturamento recorrente permanece dentro da Blesta. Quando Blesta cria uma fatura de renovação, o gateway a trata como qualquer outro pagamento de fatura.
Antes de começar
Você precisa de:
- Blesta 5.x ou superior
- Instalação Blesta HTTPS
- Acesso de administrador aos gateways de pagamento Blesta
- Liquidação e flag MakePay configuradas
Instale o gateway
Baixe o pacote mais recente:
https://plugins.makecrypto.io/downloads/blesta/latest.zip
Extraia o ZIP e carregue a pasta makepay para:
Blesta/components/gateways/nonmerchant/makepay
No Blesta, abra Configurações > Gateways de pagamento, escolha Disponível, pesquise MakePay e instale-o como um gateway não comercial.
Conecte MakePay
Abra as configurações do gateway MakePay no Blesta e clique em Conectar MakePay.
O fluxo de conexão:
- Abra a página de conexão MakePay.
- Permite escolher a empresa que receberá os pagamentos.
- Retorna você para Blesta após aprovação.
- Salve a conexão do gateway para esta instalação do Blesta.
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 lojas que não conseguem concluir a conexão guiada.
Para configuração manual, defina o método de conexão como Chave manual API e digite:
- ID da empresa MakePay
- ID da chave API
- Segredo da chave API
- Segredo de assinatura webhook
Mantenha o retorno de chamada URL exibido no Blesta acessível pela Internet pública.
Fluxo checkout
Quando um cliente escolhe MakePay para uma fatura Blesta, o gateway:
- Leia o valor, a moeda, o ID do cliente e os metadados da fatura.
- 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=blesta | Identifique a integração |
orderId=blesta_invoice_<invoiceId> | Mapeia a atividade MakePay de volta para Blesta |
invoiceId | ID principal da fatura Blesta |
clientId | ID do cliente Blesta quando disponível |
Status da fatura
| Estado MakePay | Comportamento Blesta |
|---|---|
paid, completed, confirmed, succeeded | Registre uma transação aprovada |
pending, waiting, confirming | Mantém o pagamento pendente |
failed, expired, cancelled | Registrar um pagamento recusado |
A Blesta continua responsável por ativar os serviços e automatizar a cobrança recorrente após o pagamento da fatura.
Notas de segurança
Use HTTPS, limite o acesso do administrador Blesta 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 Blesta 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 retorno de chamada Blesta URL é público e se o gateway está instalado como não-comerciante.
Se as faturas não forem atualizadas, verifique se o retorno de chamada URL exibido nas configurações está acessível e se o segredo de assinatura webhook está presente.
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.