Gateway MakePay para ClientExec

Resumo

O gateway MakePay oficial para ClientExec adiciona criptografia hospedada checkout às faturas ClientExec. ClientExec cria a fatura, o gateway cria um link de pagamento MakePay e retornos de chamada assinados marcam a fatura como paga após a compensação do pagamento.

O faturamento recorrente permanece no ClientExec. Quando ClientExec cria cada fatura de renovação, o mesmo fluxo de gateway MakePay permite que o cliente pague essa fatura.

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

Antes de começar

• ClientExec 6.8 ou superior, incluindo ClientExec 7.x
• PHP 7.4 ou superior com OpenSSL e cURL habilitados
• URL ClientExec HTTPS
• Acesso de administrador ClientExec aos processadores de pagamento
• Uma empresa MakePay onde você pode gerenciar ajustes de pagamento

Instale o gateway

Baixe o pacote ZIP mais recente:

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

Extraia o ZIP e carregue a pasta makepay para:

ClientExec/plugins/gateways/makepay

O pacote instala estes arquivos:

plugins/gateways/makepay/PluginMakepay.php
plugins/gateways/makepay/PluginMakepayCallback.php
plugins/gateways/makepay/callback.php
plugins/gateways/makepay/oauth.php
plugins/gateways/makepay/lib/*.php

No ClientExec, abra Configurações > Plugins > Processadores de pagamento, selecione MakePay e salve as configurações do processador de pagamento.

Conecte MakePay

Abra as configurações do processador MakePay e copie Conecte MakePay URL para o seu navegador. A porta de entrada:

1. Abra a página de conexão MakePay.
2. Ele pede que você faça login e escolha a empresa que receberá os pagamentos.
3. Mostra as permissões exigidas pelo gateway ClientExec.
4. Retorna você ao ClientExec após a aprovação.
5. Salva a conexão com a instalação do ClientExec.
6. Configura o retorno de chamada MakePay URL e o segredo webhook.

Configurar MakePay

Após a conexão, mantenha o método de autenticação em oauth. Verificar:

• ID da empresa MakePay
• Ativo de liquidação
• Expiração do pagamento
• Segredo de assinatura webhook
• Nome de inscrição mostrado aos clientes

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 paga uma fatura ClientExec não paga com MakePay, o gateway cria um link de pagamento hospedado e redireciona o cliente para checkout MakePay.

Campo	Propósito
source=clientexec	Identifique a integração
orderId=clientexec_invoice_<invoiceId>	Mapeia a atividade MakePay de volta para ClientExec
invoiceId	Número da fatura ClientExec
clientId	ID do cliente ClientExec quando disponível
moduleVersion	Versão instalada do gateway MakePay
clientexecVersion	Versão de tempo de execução do ClientExec quando disponível

O comprador reverte para a fatura ClientExec original após o pagamento ou cancelamento.

Faturas recorrentes

ClientExec permanece responsável por produtos recorrentes, datas de renovação, impostos, geração de faturas e e-mails de clientes. MakePay não cria um calendário de assinatura separado na v1.

Para cada fatura recorrente criada pelo ClientExec, o gateway MakePay se comporta da mesma forma que uma única fatura: ele cria um link checkout hospedado e aguarda o retorno de chamada assinado antes de marcar a fatura como paga.

Status da fatura

MakePay envia retornos de chamada assinados para:

https://billing.example.com/plugins/gateways/makepay/callback.php

Estado MakePay	Comportamento do ClientExec
paid, completed, confirmed, succeeded	Chama a aceitação de pagamento do ClientExec e registra o ID da transação
failed, expired	Registre o retorno de chamada e deixe a fatura não paga
cancelled, canceled	Registre o retorno de chamada e deixe a fatura não paga
refunded	Registre o retorno de chamada para revisão manual
Outros estados	Eles são registrados e ignorados

Notas de segurança

O gateway salva detalhes da conexão na instalação do ClientExec. Limite o acesso do administrador a operadores confiáveis ​​e desconecte o gateway do painel MakePay se uma conta de administrador ou backup de servidor for exposta.

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 o ClientExec URL é HTTPS público e se a pasta makepay foi transferida por upload para plugins/gateways. Se os clientes virem um erro checkout, confirme se MakePay está online e se a fatura não foi paga. Se os retornos de chamada não marcarem as faturas como pagas, compare o URL do retorno de chamada MakePay com o URL anterior e gire o segredo de webhook nas configurações do gateway.