[Pitch] Shopix — PIX Back em produtos da Shopee
A Shopix é um web app que permite ao usuário navegar por produtos da Shopee, conferir quanto de cashback em PIX cada produto oferece, gerar um link de afiliado, comprar e acompanhar o status do pedido até o dinheiro cair na conta.
Funciona assim:
- Usuário se cadastra e vincula uma chave PIX
- Pesquisa produtos por nome ou cola um link da Shopee
- Vê o valor do PIX Back e solicita o link de compra
- Compra na Shopee pelo link de afiliado
- Acompanha o status no app
- Após receber e avaliar o produto, o cashback cai no PIX
Stack usada
| Camada | Tecnologia |
|---|---|
| Backend | PHP (puro, sem frameworks) |
| Frontend | React |
| Banco | MySQL |
| API | Shopee Affiliate API (GraphQL) |
| Deploy | FTP + Netlify |
Estratégia deliberada: sem framework PHP. A aplicação é enxuta o suficiente para não precisar de Laravel ou similares. Mais controle, menos overhead, zero dependências ocultas.
Como usamos IA (Opencode) para construir tudo em 1 dia
O projeto foi desenvolvido com auxílio do Opencode, um CLI agentivo que opera dentro do terminal. Com o modelo Big Pickle gratuito foi possível desenvolver o app completo rapidamente (na minha experiência pessoal, infinitamente mais produtivo, rápido e assertivo do que o Github Copilot, que eu usava no CLI)
O fluxo foi:
- Prompt inicial — Descrevemos a ideia completa da Shopix em linguagem natural, com requisitos de negócio, regras de cashback, níveis de usuário, etc.
- O Opencode gerou a base — Estrutura de diretórios, classes PHP, componentes React, schema SQL.
- Interações corretivas — A cada iteração, pedíamos ajustes: "muda a lógica de nível para considerar apenas compras concluídas", "adiciona campo afiliado pai no usuário", "troca a cor primária para #ee4d2d".
- Testes reais — O agente executava scripts PHP e consultas MySQL em tempo real via terminal, validando a API da Shopee com chamadas reais e salvando as respostas como documentação.
- Testes Locais — Usamos Xampp local para desenvolver, o Opencode escreveu cada arquivo e acessou diretamente o banco de dados, acessar o phpMyAdmin só foi necessário para conferência final.
- Deploy — Opencode subiu o backend via FTP (com credenciais geradas exclusivamente para ele) em um servidor apache, construiu o Banco de Dados MySQL remotamente e Commitou o frontend no Github, que foi posteriormente vinculado ao Netlify para deploy.
Resultado: sistema funcional do zero ao deploy em aproximadamente 8 horas de trabalho interativo.
Isso não é "gerar código e rezar". Cada bloco foi revisado, testado e ajustado antes de prosseguir.
Lições técnicas que aprendemos no processo
Shopee Affiliate API é bem documentada, mas tem pegadinhas
- A autenticação usa SHA256 com
AppId + Timestamp + Payload + Secret— nada de OAuth complexo. - O header
Authorizationsegue o formatoSHA256 Credential={AppId}, Timestamp={Timestamp}, Signature={Signature}. - O endpoint é GraphQL unificado:
https://open-api.affiliate.shopee.com.br/graphql. conversionReportsó retorna 3 meses de dados — importante para o scheduler de pagamentos.subIdsnogenerateShortLinké essencial para rastrear qual usuário gerou qual pedido, mas não aceita nenhum caractere especial, dificultando geração de IDs únicos.
Estrutura de dados enxuta
Optamos por 5 tabelas principais (usuários, links, pedidos, pagamentos, níveis). Sem abstrações desnecessárias. O schema cabe em 50 linhas de SQL.
Segurança (sim, pensamos nisso)
- Chaves de API armazenadas fora do repositório, em arquivo de configuração ignorado pelo git.
- Todas as senhas com hash (password_hash/bcrypt).
- Validação de entrada em toda query de busca e link.
- Sem exposição de dados sensíveis em logs ou responses da API.
- Curta duração dos links de afiliado (15 dias) — se a compra não acontecer nesse período, o pedido expira.
O que não terceirizamos para IA
- Regras de negócio — Níveis de cashback, lógica de indicações, cálculo de comissões. Isso exige decisão humana.
- Segurança — Toda credencial foi inserida manualmente. O Opencode nunca teve acesso às chaves reais de produção.
- Decisões de UI/UX — Cores, layout, tom do app foram definidos por design brief, não por IA.
- Validação da API — As chamadas reais à Shopee foram feitas e conferidas manualmente antes de entrar em produção.
Convite
A Shopix está no ar. Se você é dev e quer testar, dar feedback ou até contribuir:
- Acesse: http://shopixback.netlify.app/
- O código é fechado (por enquanto), mas a lógica de negócio está toda documentada aqui no post.
- Dúvidas, críticas ou sugestões? É só comentar.
Se você é lojista ou afiliado, a plataforma também pode te interessar — o sistema de cashback em PIX é um diferencial competitivo real.