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

> ## Agent Instructions
> Documentação oficial da sinnu, gateway de pagamento brasileiro: Pix e cartão de crédito. O índice de todas as páginas está em https://docs.sinnu.com.br/llms.txt.
> A API (https://api.sinnu.com.br) e o checkout (https://pay.sinnu.com.br) documentados são de produção. Não há ambiente público de testes: cada chamada cria ou altera dados reais.
> A chave secreta sk_live_ fica só no servidor. O navegador recebe apenas o slug do link ou a URL do checkout.
> Unidades: amountCents do link e os valores de /api/transactions/ estão em centavos (inteiro). data.amount do webhook e amount das transações de um link estão em reais. Compare na mesma unidade.
> Status: a API de transações usa approved; o corpo do webhook usa paid; o evento é transaction.approved.
> Libere o pedido só pelo webhook assinado (X-Sinnu-Signature, validado sobre o corpo cru com constructEvent({ payload, signature, secret })) e confirme com transactions.get. Nunca pelo evento completed do Sinnu Elements nem pelos parâmetros da URL de retorno.
> Estorno é sempre do valor total. Não invente métodos, campos ou eventos: confira na referência do SDK e da API.

# Documentação para assistentes de IA

> Leve este portal para o seu assistente: em Markdown, pelo llms.txt, pelo servidor MCP da documentação ou como skill.

Cada página deste portal também existe em Markdown, num formato que assistentes e agentes de código leem sem ruído. Você escolhe como entregar: um índice para o assistente navegar, o portal inteiro num arquivo, um servidor MCP que busca as páginas durante o trabalho ou uma skill com as regras da integração.

Tudo é público e somente leitura. Nenhum desses endereços pede chave nem acessa a sua conta.

> [!NOTE]
>
> Existem dois servidores MCP. O **da documentação**, em `https://docs.sinnu.com.br/mcp`, busca e lê estas páginas. O **da sinnu**, em `https://mcp.sinnu.com.br/mcp`, consulta e altera a sua conta, pelo login no painel ou com a chave de API da empresa: veja [Servidor MCP](https://docs.sinnu.com.br/servidor-mcp/visao-geral.md). Para escrever a integração, o primeiro basta.

## Escolha o formato

| Recurso | Endereço | Quando usar |
| - | - | - |
| Índice | [`/llms.txt`](https://docs.sinnu.com.br/llms.txt) | Dar ao assistente o mapa do portal: título, resumo e endereço em Markdown de cada página, mais o contrato OpenAPI. |
| Portal completo | [`/llms-full.txt`](https://docs.sinnu.com.br/llms-full.txt) | Colar o portal inteiro numa conversa ou indexar na sua própria base. É um arquivo grande; prefira o índice quando o assistente consegue abrir links. |
| Uma página | O endereço da página com `.md` no fim | Passar só o assunto da tarefa, como `https://docs.sinnu.com.br/guias/webhooks.md`. |
| Servidor MCP da documentação | `https://docs.sinnu.com.br/mcp` | Deixar o assistente buscar e ler as páginas sozinho, no editor ou no terminal. |
| Skill | [`/skill.md`](https://docs.sinnu.com.br/skill.md) | Carregar as regras e receitas da integração sempre que a tarefa envolver a sinnu. |
| Contrato OpenAPI | [`/api/openapi.yaml`](https://docs.sinnu.com.br/api/openapi.yaml) | Gerar um cliente ou validar requisições de links, clientes e transações. |

O índice, o portal completo e o Markdown de cada página começam com **instruções para agentes**: as regras que mais causam erro numa integração, como as unidades de valor e quem libera o pedido.

## A página que você está lendo

No topo de cada página, o menu ao lado do título copia a página em Markdown, abre a versão em Markdown, leva a página para um assistente e conecta o servidor MCP da documentação ao seu editor.

Para buscar uma página por um script, acrescente `.md` ao endereço ou peça Markdown no cabeçalho `Accept`:

```bash Terminal theme={null}
curl 'https://docs.sinnu.com.br/guias/webhooks.md'

curl --header 'Accept: text/markdown' 'https://docs.sinnu.com.br/guias/webhooks'
```

## Use o llms.txt numa conversa

Comece a conversa pelo índice e descreva a tarefa. O assistente abre só as páginas de que precisa:

```text Mensagem para o assistente theme={null}
Leia https://docs.sinnu.com.br/llms.txt e escreva a rota de webhook do meu app
Next.js: valide a assinatura, confira a transação na API e marque o pedido como
pago uma vez só.
```

Use o `llms-full.txt` quando a ferramenta não abre links. Ele traz, em sequência, o título, o endereço, o resumo e o conteúdo de cada página.

## Conecte o servidor MCP da documentação

O servidor não pede autenticação. Ele oferece três ferramentas: buscar no portal, ler o conteúdo de uma página e enviar um retorno sobre a documentação.

> [tab] Claude Code
>
> ```bash Terminal theme={null}
> claude mcp add --transport http sinnu-docs https://docs.sinnu.com.br/mcp
> ```

> [tab] Cursor
>
> ```json .cursor/mcp.json theme={null}
> {
>   "mcpServers": {
>     "sinnu-docs": {
>       "url": "https://docs.sinnu.com.br/mcp"
>     }
>   }
> }
> ```

> [tab] VS Code
>
> ```json .vscode/mcp.json theme={null}
> {
>   "servers": {
>     "sinnu-docs": {
>       "type": "http",
>       "url": "https://docs.sinnu.com.br/mcp"
>     }
>   }
> }
> ```

Em outro cliente, cadastre `https://docs.sinnu.com.br/mcp` como servidor remoto por HTTP, sem cabeçalho de autenticação.

## Instale a skill

A skill reúne o que um agente precisa saber antes de escrever código com a sinnu: os caminhos de integração, as regras de dinheiro e de segurança, as receitas mínimas e onde conferir cada detalhe.

```bash Terminal theme={null}
npx skills add https://docs.sinnu.com.br
```

Se preferir instalar à mão, salve o conteúdo de [`/skill.md`](https://docs.sinnu.com.br/skill.md) como `SKILL.md` na pasta de skills do seu agente, como `.claude/skills/sinnu/SKILL.md`.

## Antes de usar o código gerado

* **A API é de produção.** Não há ambiente público de testes: uma chamada do assistente cria ou altera dados reais. Revise o código antes de rodar.
* **A chave fica no servidor.** Não cole a chave secreta numa conversa nem em código que vai para o navegador. O servidor MCP da documentação não precisa dela.
* **Confira na referência.** Se o assistente usar um método, campo ou evento que você não encontra no [SDK](https://docs.sinnu.com.br/sdk/visao-geral.md) ou na [API](https://docs.sinnu.com.br/api/introducao.md), trate como erro dele.

> [card] [Servidor MCP da sinnu](https://docs.sinnu.com.br/servidor-mcp/visao-geral.md)
>
> Consulte a sua conta numa conversa, pelo login no painel ou com a chave de API.

> [card] [Crie seu primeiro link](https://docs.sinnu.com.br/inicio/primeiro-link.md)
>
> A primeira chamada à API, passo a passo.


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