Use com IA
A SuyPay funciona com as ferramentas de IA que você já usa para programar e criar apps: Claude, Codex, ChatGPT, Lovable, Cursor, GitHub Copilot, Windsurf, Gemini, v0, Bolt e Replit. Escolha a sua abaixo e copie a configuração.
Docs que a IA lê
Toda a documentação existe em texto puro, no formato que os assistentes leem melhor (llms.txt):
| Endereço | O que tem |
|---|---|
/llms.txt |
o índice: cada página com uma linha dizendo o que ela ensina |
/llms-full.txt |
todas as páginas num arquivo só, para anexar numa conversa |
/<página>.md |
uma página em Markdown, como /payments.md |
/openapi.json |
todas as rotas da API, para gerar cliente ou validar chamadas |
No topo de cada página, Copiar página copia o texto em Markdown, e a setinha ao lado abre a página no ChatGPT ou no Claude.
Conectar pelo MCP
Assistentes de código (Claude Code, Codex, Cursor, Copilot, Windsurf, Gemini) conectam no servidor MCP da SuyPay e passam a criar cobranças, ver vendas, responder contestações e registrar entregas conversando. As ferramentas estão em Usar com IA (MCP).
- Endereço:
https://api.suypay.com/mcp - Cabeçalho:
Authorization: Bearer suy_test_...
Atenção: guarde a chave numa variável de ambiente (
SUYPAY_KEY), nunca dentro do código nem num arquivo que vai para o Git. Comece pela chave de teste: com a real, o assistente move dinheiro de verdade.
Apps criados por IA
Lovable, v0, Bolt e Replit escrevem o app inteiro. Dê o pedido abaixo para eles e confira três coisas no que gerarem:
- A chave só no servidor. A chamada para a SuyPay fica numa função do servidor (Edge Function, rota de API), com a chave nos segredos do projeto. Se a chave aparecer no código do navegador, qualquer visitante consegue usar.
- O pago vem do webhook. O app libera o pedido quando chega
payment.succeededno webhook, com a assinatura conferida. Nunca porque a tela de obrigado abriu. - Valores em centavos. R$ 49,90 é
4990.
Leia https://docs.suypay.com/llms.txt e integre a SuyPay neste projeto.
- Chame a API só do lado do servidor, com a chave em SUYPAY_KEY. Nunca no navegador.
- Valores em centavos. Crie a cobrança com POST /v1/payments e mande o cliente para payment_url.
- Confirme o pagamento pelo webhook payment.succeeded (confira a assinatura), não pela tela.
- Comece com uma chave de teste (suy_test_...).
Por que funciona bem com IA
- Erros em português, com código. Cada erro diz o que fazer e traz um código estável (
missing_document,amount_too_low), então o assistente corrige sozinho. Veja Erros. - Uma API só para todas as contas. O mesmo
POST /v1/paymentsserve Mercado Pago, Asaas, Efí, Stripe e as outras: a IA não precisa aprender cada uma. - Modo de teste completo. A conta de teste confirma pagamentos e abre contestações de mentira, para a IA testar o fluxo inteiro sem dinheiro real. Veja Modo de teste.