1

[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:

  1. Usuário se cadastra e vincula uma chave PIX
  2. Pesquisa produtos por nome ou cola um link da Shopee
  3. Vê o valor do PIX Back e solicita o link de compra
  4. Compra na Shopee pelo link de afiliado
  5. Acompanha o status no app
  6. Após receber e avaliar o produto, o cashback cai no PIX

Stack usada

CamadaTecnologia
BackendPHP (puro, sem frameworks)
FrontendReact
BancoMySQL
APIShopee Affiliate API (GraphQL)
DeployFTP + 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:

  1. 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.
  2. O Opencode gerou a base — Estrutura de diretórios, classes PHP, componentes React, schema SQL.
  3. 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".
  4. 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.
  5. 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.
  6. 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 Authorization segue o formato SHA256 Credential={AppId}, Timestamp={Timestamp}, Signature={Signature}.
  • O endpoint é GraphQL unificado: https://open-api.affiliate.shopee.com.br/graphql.
  • conversionReport só retorna 3 meses de dados — importante para o scheduler de pagamentos.
  • subIds no generateShortLink é 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.

Carregando publicação patrocinada...
1
1
0