Manual de integração

Do cadastro à primeira venda: tudo o que você precisa para ligar o PIXNET no seu MikroTik (RouterOS 6.49.x ou 7.x).

Como o sistema funciona

Cliente conecta no Wi-Fi → o hotspot abre o portal PIXNET → ele escolhe o plano e paga por PIX → o Mercado Pago confirma → o roteador baixa o script de liberação a cada 10 segundos → o aparelho é autenticado pelo MAC e navega. Nada é digitado pelo cliente.

Passo a passo

Do cadastro à primeira venda

1 Crie sua conta e o provedor

Acesse /register.php, informe empresa, e-mail e senha. A conta já entra em período de teste, com um slug (identificador) e uma chave de API gerados automaticamente.

2 Configure o Mercado Pago

No painel da empresa → aba Configurações, cole seu Access Token de produção do Mercado Pago. É nele que o dinheiro das vendas do hotspot cai — direto na sua conta.

3 Cadastre os planos de internet

Aba Planos: nome, preço, duração em minutos, download e upload em Mbps. Cada plano vira um profile no hotspot do MikroTik.

4 Personalize o portal

Aba Marca: envie logo, banner e escolha as cores. O visual vale para o portal na web e para a tela de login do hotspot.

5 Confira os dados do roteador

Aba MikroTik: interface da LAN (ex.: ether2 ou bridge-lan), faixa de IP, nome do hotspot e a URL do portal (https://pixnet.maxnet.click).

6 Baixe o script .rsc

Ainda na aba MikroTik, baixe pixnet-routeros7.rsc (RouterOS 7.x) ou pixnet-routeros6.rsc (6.49.x). Ele cria bridge, pool, DHCP, hotspot, perfis, NAT, walled garden e os agendadores.

7 Envie o arquivo para o roteador

Winbox → Files → arraste o .rsc para dentro da lista de arquivos.

8 Importe no terminal

Winbox → New Terminal e rode:
/import file-name=pixnet-routeros7.rsc
Se quiser ver cada linha: acrescente verbose=yes.

9 Suba os arquivos do hotspot

Baixe o pixnet-hotspot.zip no painel, extraia e envie login.html e alogin.html para a pasta hotspot em Files (em roteadores com flash, a pasta aparece como flash/hotspot).

10 Teste com um celular

Conecte no Wi-Fi do hotspot. Deve abrir o portal com seus planos. Toque no botão de 2 minutos para validar a liberação de teste.

11 Faça uma venda real

Escolha um plano, pague o PIX. Em até ~10 segundos o roteador sincroniza e o aparelho passa a navegar no plano pago automaticamente.

12 Acompanhe tudo pelo painel

Aba Vendas: pagamentos, vouchers, status e histórico. A assinatura da plataforma é paga na aba Assinatura, também por PIX.

Terminal

Comandos úteis

Importar o script:
/import file-name=pixnet-routeros7.rsc

Ver os agendadores criados:
/system scheduler print

Ver quem está conectado:
/ip hotspot active print

Forçar uma sincronização agora:
/system script run pixnet-sync

Ver os perfis criados:
/ip hotspot user profile print

Ajuda

Solução de problemas

SituaçãoO que fazer
O portal não abre no celularConfira se login.html está na pasta hotspot e se o walled garden liberou o domínio do portal (o script já faz isso).
login failed: invalid username or passwordO roteador ainda não sincronizou. Aguarde ~10s. Verifique se o agendador pixnet-sync existe em System → Scheduler.
Sincronização não rodaCheque data/hora e DNS do roteador (o script configura NTP). Teste: /tool fetch url="https://pixnet.maxnet.click/api/vouchers.php?key=SUA_CHAVE" dst-path=teste.rsc.
Cliente pagou e não navegouAbra IP → Hotspot → Active. O MAC deve aparecer no profile do plano pago. Se não aparecer, rode o sync manualmente e confira a chave de API.
Empresa bloqueadaCom a assinatura vencida a venda é bloqueada no portal e o sync derruba as sessões. Pague a assinatura na aba Assinatura e tudo volta no próximo ciclo de 10s.

Ficou com dúvida?

Nosso suporte ajuda na primeira instalação.

Abrir meu painel