Provedor de pagamento MakePay para XenForo

Resumo

O complemento MakePay oficial para XenForo adiciona criptografia hospedada checkout a perfis XenForo pagos. O XenForo cria a solicitação de compra, MakePay cria o link de pagamento hospedado e o manipulador de retorno de chamada de pagamento do XenForo conclui a compra após um webhook MakePay assinado.

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

Antes de começar

• XenForo 2.3 ou superior
• PHP 8.1 ou superior com OpenSSL habilitado
• Fórum URL/Comunidade HTTPS
• Acesso de administrador a perfis de pagamento
• Uma empresa MakePay onde você pode gerenciar ajustes de pagamento

Instale o complemento

Baixe o pacote ZIP mais recente:

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

Instale-o usando o instalador de arquivo complementar do XenForo ou carregue o conteúdo do diretório upload/ para a raiz do XenForo. O ID do complemento é MakePay/Payment e o código-fonte está instalado em:

src/addons/MakePay/Payment

Conecte MakePay

Vá para Opções > Provedores de serviços > Perfis de pagamento > Adicionar perfil de pagamento e escolha MakePay. Salve o perfil uma vez, abra-o novamente e escolha Conectar MakePay. O complemento:

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 necessárias ao provedor de pagamento XenForo.
4. Retorna você ao XenForo após passar.
5. Salve a conexão nas opções do perfil de pagamento.
6. Configura o retorno de chamada MakePay URL 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. Verificar:

• ID da empresa MakePay
• Moeda de liquidação
• Expiração do link de pagamento
• Retorno de chamada webhook URL
• 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

Adicione o perfil pago MakePay a uma atualização de usuário XenForo, recurso pago ou outro fluxo adquirível que suporte perfis pagos. Quando um membro escolhe MakePay, o add-on cria um link de pagamento MakePay com metadados XenForo.

Campo	Propósito
source=xenforo	Identifique a integração
orderId=xenforo_purchase_<requestKey>	Mapeie a atividade MakePay de volta para XenForo
requestKey	Chave de solicitação de compra XenForo
purchasableTypeId	Tipo acessível XenForo
moduleVersion	Versão instalada do complemento MakePay
xenforoVersion	Versão de tempo de execução do XenForo

O comprador é redirecionado para o MakePay hospedado em checkout e retorna ao XenForo após o pagamento ou cancelamento.

Status de pagamento

MakePay envia retornos de chamada assinados para:

https://your-forum.example/payment_callback.php?_xfProvider=makepay

Estado MakePay	Resultado de retorno de chamada do XenForo
paid, completed, confirmed, succeeded	Pagamento recebido
failed, expired	Pagamento revertido
cancelled, canceled	Pagamento revertido
refunded	Pagamento revertido
Outros estados	Brinco

O XenForo registra o log do provedor de pagamento com o pagamento UID MakePay, chave de solicitação de compra, pagamento URL quando disponível e carga útil de retorno de chamada.

Notas de segurança

O complemento salva os detalhes da conexão nas opções do perfil de pagamento. Limite o acesso de administrador do XenForo a operadores confiáveis ​​e coloque a comunidade off-line 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 o fórum XenForo URL é HTTPS e acessível publicamente. Se o botão Conectar MakePay estiver faltando, salve seu perfil de pagamento uma vez e reabra-o. Se as compras não forem concluídas, compare o retorno de chamada URL webhook MakePay com URL payment_callback.php?_xfProvider=makepay do XenForo e gire o segredo webhook.