> ## 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.

# Fundamentos visuais

> Cor, tipografia e hierarquia para interfaces claras no ecossistema sinnu.

O design system usado nas aplicações da sinnu combina superfícies escuras, destaque lima e texto de alto contraste. Neste portal, o tema claro tem um verde mais escuro para manter a leitura dos links.

## Cor com função

| Token da interface | Valor | Papel |
| - | - | - |
| `brand.lime` | `#C6F211` | Ação principal e destaque. |
| `surface.canvas` | `#0A0B09` | Fundo principal escuro. |
| `surface.surface` | `#141511` | Superfície de conteúdo. |
| `text.primary` | `#F4F4EF` | Texto principal sobre fundo escuro. |
| `brand.amber` | `#E8B54A` | Situações de espera. |
| `brand.coral` | `#E86A4A` | Atenção e falhas. |

Texto sobre lima deve ser escuro. Use texto e ícone para identificar um estado; a cor reforça a mensagem.

## Tipografia

**Instrument Sans** sustenta a leitura da interface. **Space Grotesk** aparece em títulos e números de destaque. Use uma fonte monoespaçada para identificadores e código.

Não transforme o logotipo em texto com uma fonte parecida: use os arquivos oficiais da marca.

## Hierarquia

Reserve o botão lima para a ação principal. Agrupe informações do mesmo pagamento, mostre o valor com sua unidade e escreva a ação por inteiro: “Ir para o pagamento” comunica melhor do que “Continuar” fora de contexto.

## Pacotes internos

`@repo/design` contém tokens TypeScript e CSS; `@repo/ui` reúne componentes de interface do workspace. Se você desenvolve dentro do monorepo, use essas fontes. Eles não são publicados: numa aplicação externa, use as receitas desta documentação.

O pacote público de interface da sinnu é o `@sinnu-dev/elements`, do Sinnu Elements, que embute o checkout no seu site. As cores, os cantos e a fonte dele se ajustam pela [aparência do Sinnu Elements](https://docs.sinnu.com.br/elements/aparencia.md), não pelos tokens acima.


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