Gateway Wix Velo

Resumo

MakePay para Wix usa o plugin de serviço Wix Velo Payment Provider. O comerciante adiciona quatro arquivos JavaScript de MakePay ao editor Wix, instala crypto-js, conecta o provedor de pagamento em Configurações > Aceitar pagamentos e salva segredos API no Wix Secrets Manager.

Em checkout, o Wix chama createTransaction(). O arquivo backend MakePay cria um link de pagamento hospedado MakePay e retorna o redirecionamento URL para Wix. Quando MakePay confirma o pagamento, um webhook assinado chama a função Wix HTTP e o código publica o pagamento no pedido Wix.

Antes de começar

Você precisa de:

• Uma loja Wix com Modo Desenvolvedor habilitado
• Permissão para editar arquivos de back-end e plug-ins de serviço do Velo
• Permissão para usar o Wix Secrets Manager
• Uma empresa MakeCrypto com liquidação MakePay configurada
• Uma chave API MakePay com acesso para escrever links pagos
• Um segredo webhook MakePay para a empresa

Criar credenciais MakePay

Em MakeCrypto:

1. Selecione a empresa que receberá os pagamentos Wix.
2. Abra Carteira > Saldos e configure a liquidação.
3. Abra Integrações > Integrações API e crie uma chave API.
4. Dê a chave pelo menos:
   • makepay:payment-links:read
   • makepay:payment-links:write
5. Copie o ID da empresa, o ID da chave API e o segredo da chave API.
6. Abra Comerciante > Configurações de pagamento e gire ou copie o segredo webhook.

O segredo da chave API e o segredo webhook são adicionados ao Wix Secrets Manager, não ao código frontend.

Adicionar arquivos Wix Velo

Abra o repositório de origem MakePay para Wix:

https://github.com/makecryptoio/makepay-wix

O mesmo código é mantido neste monorepo em apps/plugins/wix.

No Wix:

1. Abra o editor do site e ative o Modo Desenvolvedor.
2. Em Público e back-end > Back-end, crie:
   • MakePay.js
   • http-functions.js
3. Em Plugins de serviço, crie um plug-in de Pagamento chamado MakePayPayment.
4. Cópia:
   • MakePayPayment-config.js
   • MakePayPayment.js
5. Instale o pacote npm crypto-js em Pacotes e Aplicativos.
6. Publique o site.

Adicionar segredos Wix

Abra Ferramentas do desenvolvedor > Gerenciador de segredos e adicione:

Nome secreto	Valor
makepay_api_key_secret	A chave secreta API MakePay
makepay_webhook_secret	O segredo de webhook MakePay

Não cole esses valores no código da página ou em arquivos de front-end públicos.

Conecte MakePay no Wix

Abra Configurações > Aceitar pagamentos no painel Wix e conecte o provedor de pagamento personalizado MakePay.

Digitar:

Campo	Valor
MakePay company ID	ID da empresa MakeCrypto
MakePay API key ID	ID da chave API MakePay
Settlement currency	Normalmente USDT

O título do método de pagamento em checkout é:

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

Configurar webhooks

O endpoint da função HTTP do Wix é:

https://your-wix-domain.com/_functions/makepay_notify

Em MakeCrypto, abra Comerciante > Configurações de pagamento e configure o retorno de chamada MakePay URL com esse endpoint. O segredo webhook no Wix Secrets Manager deve corresponder ao segredo webhook MakePay.

O manipulador Wix webhook verifica o cabeçalho X-MakePay-Signature antes de marcar qualquer pedido como pago.

Experimente checkout

1. Adicione um produto de baixo valor ao carrinho Wix.
2. Vá para checkout.
3. Escolha o método de pagamento criptográfico MakePay.
4. Clique em Fazer pedido e pagar.
5. Confirme se o Wix redireciona para checkout hospedado em MakePay.
6. Conclua um pagamento experimental.
7. Confirme se o pedido Wix está marcado como pago após receber o webhook.
8. Verifique Integrações > Solicitações Webhook em MakeCrypto se a solicitação não estiver atualizada.

Notas de segurança

A integração Wix utiliza autenticação com chave API porque os arquivos Velo do provedor de pagamento copiados pelo lojista ainda não suportam o fluxo automático Connect MakePay.

Mantenha estas regras:

• Salve segredos apenas no Wix Secrets Manager.
• Ele usa uma chave específica de API de MakePay, não uma chave interna ampla.
• Não conceda escopos de envio de carteira ou gerenciamento de chaves API.
• Gire a chave API e o segredo webhook se alguém com acesso antigo ao editor Wix não precisar mais gerenciar pagamentos.
• Mantenha o retorno de chamada HTTPS URL público.

Solução de problemas

Se o provedor não estiver listado em Aceitar pagamentos, confirme se o plug-in do serviço se chama MakePayPayment, se ambos os arquivos do plug-in existem e se o site foi publicado após a adição do código.

Se Connect falhar, confirme se makepay_api_key_secret existe no Wix Secrets Manager e se o ID da chave API/ID da empresa corresponde à mesma empresa MakeCrypto.

Se checkout não redirecionar, inspecione os logs do Wix Velo em busca do erro createTransaction e confirme se a chave API tem makepay:payment-links:write.

Se os pedidos não forem atualizados, confirme se o retorno de chamada URL de MakeCrypto é https://your-wix-domain.com/_functions/makepay_notify, se o segredo de webhook corresponde e se os logs de entrega de MakeCrypto mostram uma resposta 2xx.