Integre com IA
Um assistente que escreve integração de pagamento a partir da memória inventa campo. Este prompt
resolve isso do jeito mais simples: ele manda o assistente ler a documentação inteira
(/llms-full.txt) e a referência da API (/openapi.json) antes
de escrever qualquer linha, e proíbe as duas coisas que costumam vazar em integração gerada por IA,
chave live no front-end e campo inventado.
Antes de colar, troque dois pedaços
O prompt tem dois espaços em branco no meio. Troque os dois:
{{stack}}: a sua stack, com o máximo de detalhe que der. Exemplo:Next.js 15 com App Router, TypeScript e Prisma no Postgres.{{chave_de_teste}}: a sua chavesk_test_, tirada do painel em app.leztypay.com. É chave de teste, não move dinheiro. Nunca cole uma chavesk_live_em um chat.
O prompt
Você vai integrar a LeztyPay, um gateway de pagamentos PIX brasileiro: a API cria uma cobrança PIX, entrega um webhook assinado quando ela é paga e permite sacar o saldo para uma chave PIX.
Antes de escrever qualquer linha de código, leia estas duas fontes:
- https://docs.leztypay.com/llms-full.txt (a documentação inteira em texto)
- https://docs.leztypay.com/openapi.json (a referência da API, OpenAPI 3.1, com todos os campos)
Ambientes: a mesma API atende os dois, na base URL https://api.leztypay.com. Uma chave que começa com sk_test_ põe a conta no ambiente de teste, onde nenhum dinheiro se move e o resultado de cada cobrança é escolhido pelos dois últimos dígitos do valor. Uma chave sk_live_ vale dinheiro de verdade. Comece no teste e só troque a chave no fim.
Minha stack é {{stack}} e minha chave de teste é {{chave_de_teste}}.
Implemente nesta ordem:
1. Criação de cobrança PIX, sempre com um header Idempotency-Key próprio por tentativa de cobrança.
2. Receptor do webhook: verifique a assinatura sobre o corpo cru antes de desserializar, responda 2xx rápido e processe em segundo plano.
3. Idempotência no receptor: o mesmo evento pode chegar mais de uma vez e fora de ordem, então deduplique pelo id do evento e reconcilie consultando a cobrança.
Regras que você não pode quebrar:
- A chave sk_live_ nunca aparece no front-end, em repositório, em log nem em mensagem de erro. Ela fica em variável de ambiente ou cofre, e só o servidor a usa.
- Nenhum nome ou formato de campo sai da sua memória: confira cada um no openapi.json.
- Se alguma coisa não estiver na documentação, diga que não está em vez de inventar.
Abrir no ChatGPT Abrir no Claude
Copie o prompt, abra o assistente e cole. Ele vai buscar as duas fontes sozinho.
Se o assistente não conseguir abrir links
Alguns assistentes rodam sem acesso à internet. Nesse caso, abra
/llms-full.txt, copie o conteúdo e cole no chat antes do prompt. É a mesma
documentação deste site, em texto, na mesma ordem.