Gateway MakePay para comunidade Invision

Resumo

O aplicativo MakePay oficial para Invision Community adiciona criptografia hospedada checkout ao Invision Community 5 Commerce. O Commerce cria a fatura e a transação, MakePay cria o link de pagamento hospedado e o webhooks assinado atualiza a transação após os eventos de pagamento.

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

Antes de começar

• Comunidade Invision 5.0 ou superior
• Aplicativo de comércio instalado
• PHP 8.1 ou superior
• URL Comunidade HTTPS
• Uma empresa MakePay onde você pode gerenciar ajustes de pagamento

Instale o aplicativo

Baixe o pacote TAR mais recente:

https://plugins.makecrypto.io/downloads/invision-community/latest.tar

Instale-o a partir do gerenciador de aplicativos Invision AdminCP.

Conecte MakePay

Abra suas configurações de pagamento do Commerce e adicione MakePay como forma de pagamento. Escolha Conectar MakePay. A aplicação:

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 exigidas pelo gateway do Invision Community.
4. Retorna você ao Invision após passar.
5. Salve a conexão da comunidade nas configurações criptografadas do Invision.
6. Configura o retorno de chamada URL de webhook MakePay.

Configurar MakePay

Mantém o método de conexão no modo conectado padrão após a conexão. Verificar:

• Disponibilidade da forma de pagamento
• ID da empresa MakePay
• Retorno de chamada webhook URL
• Registro de depuração/solicitação
• Credenciais de fallback com chave manual API

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 membro escolhe MakePay, o Invision cria uma transação comercial e o aplicativo cria um link de pagamento MakePay com metadados da fatura.

Campo	Propósito
source=invision	Identifique a integração
externalId=invision_invoice_<id>	Mapeia a atividade MakePay de volta ao Commerce
invoiceId	ID da fatura comercial do Invision
transactionId	ID de transação do Invision Commerce
moduleVersion	Versão instalada do aplicativo MakePay

O membro é redirecionado para o MakePay hospedado em checkout e retorna à comunidade após pagamento ou cancelamento.

Estados Comerciais

O terminal webhook verifica X-MakePay-Signature antes de alterar o status da transação Commerce.

Estado MakePay	Status da transação Invision
paid, completed, confirmed, succeeded	Aprovado
failed, expired	Recusado
cancelled, canceled	Recusado
refunded	Reembolsado
Outros estados	Pendente

Cada webhook grava uma mensagem de fatura privada com status MakePay, Pagamento UID e Pagamento hospedado URL, quando disponível.

Notas de segurança

O aplicativo salva detalhes da conexão em configurações criptografadas do Invision. Limite o acesso AdminCP a operadores confiáveis ​​e desconecte o gateway em MakeCrypto 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 não for iniciado, confirme se a base da comunidade URL é HTTPS e acessível publicamente. Se os redirecionamentos checkout falharem, confirme se o Commerce está instalado e se MakePay tem uma conexão salva ou credenciais manuais. Se as faturas não forem atualizadas, compare o retorno de chamada URL de webhook MakePay com o URL de webhook da comunidade e gire o segredo.