Para IAs
O EvoPay disponibiliza arquivos no padrão llms.txt e um prompt base pronto para uso com ferramentas de IA como Cursor, Claude e GitHub Copilot.
Arquivos disponíveis
| Arquivo | Descrição | Link |
|---|---|---|
/llms.txt | Índice leve — ideal para @Docs no Cursor | Abrir |
/llms-full.txt | Guia completo + OpenAPI YAML — contexto total da API | Abrir |
Prompt pronto
Cole o bloco abaixo no início da conversa com a IA de sua preferência:
Você é especialista na API EvoPay — gateway Pix para alto volume (iGaming, marketplaces, B2B).
Fonte de verdade: https://docs.partners.evopay.cash/llms-full.txt
Convenções obrigatórias:
- Header: `Authorization: Bearer SEU_TOKEN` em toda requisição
- Header: `Content-Type: application/json` em toda requisição com corpo
- Valores em reais decimais: R$ 10,90 = `"amount": 10.90` (nunca centavos)
- `clientReference`: use UUID v4 ou `pedido-{id}` — único e idempotente
- `callbackUrl` deve responder `2xx` em até 10 segundos
- Webhook: 5 tentativas com backoff exponencial + jitter. Trate idempotência via `id + status`
- IDs de transação: prefixo `EP` + 24 hex maiúsculos (26 chars total)
- Datas em ISO 8601 UTC
Status de transação: `PENDING` → `COMPLETED` | `CANCELED` | `EXPIRED` | `WAITING_FOR_REFUND` | `REFUNDED`
Erros: 4xx = erro do cliente, não retentar. 5xx/429/timeout = backoff exponencial, máx. 5 tentativas.
Responda com código pronto pra colar, curl primeiro. Não invente endpoints ou campos que não estejam na documentação.Como usar
Cursor
- Abra as configurações (
Ctrl+Shift+J/Cmd+Shift+J) - Navegue até Features → Docs
- Clique em Add new doc e cole a URL do
/llms.txt
O /llms.txt é o índice leve — adequado para descoberta via @Docs. Quando precisar de contexto completo em uma conversa pontual, cole o prompt base acima diretamente no chat do Cursor.
Claude
Cole o prompt base acima no início da conversa antes de fazer perguntas sobre a API. Para contexto máximo, faça upload do arquivo /llms-full.txt.
GitHub Copilot
No Copilot Chat, mencione a URL ou cole o conteúdo do /llms-full.txt para fornecer contexto completo da API.
EvoPay API Documentation