> ## Documentation Index
> Fetch the complete documentation index at: https://dev.valorapayments.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Valora Payments API (Brazil: Pix, card, boleto). Base URL https://api.valorapayments.com.br, Authorization: Bearer sk_vl_... used only on the server. Request amounts are reais as strings ("149.90"); response amounts are integer cents (14990). Use POST /v1/checkouts for card and boleto; POST /v1/payments only creates Pix and should send an Idempotency-Key. Confirm payments only through the payment.succeeded webhook after verifying X-Valora-Signature (hex HMAC-SHA256 of "<t>.<raw body>"), dedupe by event.id and check livemode. Never invent endpoints or fields: check /llms.txt and /openapi.json.

# Integre com IA

> Dê ao seu agente de código (Claude Code, Cursor, Copilot, Codex) a documentação e as regras da Valora para integrar mais rápido e sem erros.

Agentes de IA escrevem integrações de pagamento rápido, mas erram nos detalhes: valor em reais ou em centavos, onde fica a chave, como verificar a assinatura do webhook. Esta seção dá ao seu agente o contexto certo, em quatro formatos.

> [card] [Servidor MCP](https://dev.valorapayments.com.br/ia/mcp.md)
>
> O agente pesquisa a documentação da Valora sozinho, sempre na versão mais nova.

> [card] [Prompts prontos](https://dev.valorapayments.com.br/ia/prompts.md)
>
> Copie e cole para integrar checkout, Pix ou webhook.

> [card] [Regras para o projeto](https://dev.valorapayments.com.br/ia/regras.md)
>
> Um `AGENTS.md` com as regras da Valora para o agente seguir sempre.

> [card] [Skill para agentes](https://dev.valorapayments.com.br/ia/skill.md)
>
> Instale a skill da Valora no Claude Code, no Cursor e em outros agentes.

## Documentação em formato para IA

Toda página desta documentação também existe em Markdown limpo, sem menu nem layout:

| Recurso | Endereço | Uso |
| - | - | - |
| Página em Markdown | adicione `.md` ao fim da URL, ex.: `/integrar/webhooks.md` | colar uma página no chat |
| Índice | `/llms.txt` | lista de todas as páginas com descrição |
| Documentação inteira | `/llms-full.txt` | todo o conteúdo num arquivo só |
| Especificação da API | [`/openapi.json`](https://dev.valorapayments.com.br/openapi.json) | gerar cliente tipado ou dar ao agente os campos exatos |
| MCP | `/mcp` | pesquisa ao vivo pelo agente |

No topo de cada página, o menu **Copiar página** copia o Markdown ou abre a página direto no ChatGPT, no Claude, no Perplexity, no Cursor ou no VS Code.

## Caminho recomendado

**1. Conecte o MCP**

Assim o agente consulta a documentação em vez de adivinhar. Veja [Servidor MCP](https://dev.valorapayments.com.br/ia/mcp.md).

**2. Adicione as regras ao projeto**

Cole o bloco de [Regras para o projeto](https://dev.valorapayments.com.br/ia/regras.md) no `AGENTS.md` (ou `CLAUDE.md`, `.cursor/rules`).

**3. Use um prompt pronto**

Escolha a tarefa em [Prompts prontos](https://dev.valorapayments.com.br/ia/prompts.md) e cole no agente.

**4. Revise o que é crítico**

Antes de ir para produção, revise você mesmo três pontos: a chave fica só no servidor, a assinatura do webhook é verificada com o corpo cru e o pedido só é liberado por `payment.succeeded`.

> [!WARNING]
>
> Nunca cole a sua chave de API ou o segredo do webhook no chat de um agente. Deixe os valores em variáveis de ambiente e diga ao agente só o **nome** da variável.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.