Agent Skill da LuniumPay — integre Pix ⇄ USDT pelo seu agente de IA

Instale uma vez no seu agente de código e peça em português: “quero receber Pix e cair em USDT na minha carteira”. O agente cria a chave em uma chamada, escreve o backend na sua stack, mostra o QR exatamente como a API devolve, configura o webhook assinado, prova tudo no sandbox e só então vai para produção.

Funciona em Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Antigravity e qualquer agente que leia o padrão Agent Skills. Sem o comando: copie as pastas para .claude/skills/, .cursor/skills/ ou equivalente.

No Claude Code também pelo marketplace de plugins, com atualizações: /plugin marketplace add LuniumPay/lunium-agent-skills e /plugin install luniumpay@lunium-agent-skills. Para montar a integração no projeto em um comando: node luniumpay/scripts/init.mjs --email voce@empresa.com (detecta Next.js, Express, FastAPI ou Supabase, grava as rotas e o webhook da receita oficial sem sobrescrever nada, cria a chave de sandbox no .env).

O que vem dentro

Skill	Quando o agente usa	Extras
`luniumpay`	Comece aqui: pitch, árvore de decisão, roteiro de 7 passos, 11 regras, o que o sandbox simula	estados, erros, checklist de produção, FAQ do dono, prompts, MCP (20 tools), produção por stack, `init.mjs`, `doctor.mjs`, `go-live.mjs`
`luniumpay-pix-charge`	Receber Pix → USDT/USDC na carteira (ou saldo)	receitas Next.js, Express, FastAPI, Supabase Edge, componente React de checkout, `smoke.mjs`
`luniumpay-custody`	Saldo em reais sem carteira, subcontas por cliente, retenção e carência, saque em cripto, Pix com saldo	`smoke-custody.mjs` (inclui carência)
`luniumpay-webhooks`	Receber eventos assinados com segurança	verificador oficial + teste
`luniumpay-crypto-sale`	Pagar Pix com cripto (cash-out): catálogo, prévia, ordem, aceite, devolução	`smoke-cashout.mjs`
`luniumpay-usdt-wallet`	Saldo em USDT e Pix pago com ele
`luniumpay-verify-payment`	Provar que um Pix liquidou, sem chave

Como o agente trabalha com a skill

Pergunta destino (carteira ou saldo), rede e endereço, e o e-mail de quem testa.
POST /keys/sandbox → chave lun_test_ no .env. Nunca no código, nunca no chat.
Escreve as rotas de cobrança e status na sua stack e o endpoint de webhook com corpo cru e HMAC.
Mostra qr_image_url e qr_copypaste da API. Nada é gerado pelo modelo.
Roda os scripts de sandbox, inclusive um cenário de falha. Dinheiro fictício; os scripts recusam chave de produção. init.mjs monta tudo no projeto em um comando.
POST /keys → chave lun_live_ na hora. Troca só a variável de ambiente.

O que a skill não deixa o agente fazer

Liberar pedido por HTTP 200 ou pelo webhook cashin.paid: só com status=paid e settlement_status=sent relidos no status.
Repetir cobrança, depósito ou saque em estado incerto.
Gravar taxas, mínimos ou rotas no código: tudo é lido em tempo de execução.
Colocar chave ou segredo no frontend, no repositório ou na conversa.
Prometer prazo fixo ou câmbio travado.

Teste sem dinheiro

export LUNIUM_SANDBOX_EMAIL=voce@empresa.com
node luniumpay-pix-charge/scripts/smoke.mjs cripto success
node luniumpay-pix-charge/scripts/smoke.mjs cripto failed
node luniumpay-custody/scripts/smoke-custody.mjs
node luniumpay-crypto-sale/scripts/smoke-cashout.mjs USDT polygon
node luniumpay-crypto-sale/scripts/smoke-cashout.mjs DEPIX liquid settlement_uncertain
node luniumpay/scripts/doctor.mjs

Produção em um comando

node luniumpay/scripts/go-live.mjs --name "Minha Empresa" --email voce@empresa.com \
  --webhook https://seu-dominio.com/api/webhooks/lunium --vercel --deploy

Chave lun_live_ na hora, webhook cadastrado com segredo, variáveis gravadas no host (nunca impressas), deploy e POST /webhooks/test lido na mesma chamada, mostrando o HTTP que o seu endpoint respondeu. Sem carteira: --destino saldo. Outros hosts: --env grava um arquivo 0600. Guia por stack em luniumpay/references/producao.md.

Fonte de verdade: openapi.json · llms.txt · integration.json · sandbox. Versão 2.2.0 · API 1.45.2 · revisão 25/10/2026. Licença MIT.

English

Install the LuniumPay Agent Skill in Claude Code, Cursor, Codex or Gemini CLI and ask “accept Pix and settle in USDT to my wallet”. The agent creates the key in one call, writes the backend for your stack, renders the API QR, wires the signed webhook, proves everything in the sandbox and only then goes live with POST /keys. Seven short skills point to the live contract; sandbox scripts refuse production keys and move no real funds. GitHub.

Suporte: contato@luniumpay.com · WhatsApp · Lunium Partners (recomendado).