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

# Instalação e disponibilidade

> Como instalar o SDK publicado no npm e o que ele exige do ambiente.

O `@sinnu-dev/sdk` está publicado no registro público do npm. A versão atual, a data de
cada publicação e o que mudou estão na [página do pacote](https://www.npmjs.com/package/@sinnu-dev/sdk).

```bash Terminal theme={null}
npm install @sinnu-dev/sdk
```

O import usado nos exemplos é:

```ts TypeScript theme={null}
import { Sinnu } from "@sinnu-dev/sdk";
```

O pacote traz ESM, CommonJS e tipos. Em projetos CommonJS (`require`), use a 0.2.1 ou
superior: a 0.2.0 falhava ao carregar. O histórico de versões está no
[CHANGELOG](https://github.com/Sinnu-com/sinnu/blob/main/sdk/typescript/CHANGELOG.md).
Enquanto estiver em `0.x`, uma mudança incompatível sobe o minor; fixe a versão
no `package.json` da sua aplicação.

## Para quem trabalha no monorepo

O pacote está em `sdk/typescript` e integra o workspace pnpm de `clients/`.

```bash Raiz do monorepo theme={null}
cd clients
pnpm install
pnpm --filter @sinnu-dev/sdk build
pnpm --filter @sinnu-dev/sdk type-check
```

Uma aplicação do mesmo workspace pode usar `"@sinnu-dev/sdk": "workspace:*"` nas dependências.

## Ambiente

O pacote declara Node.js 18 ou superior. Prefira uma versão LTS mantida. O SDK precisa de `fetch` e os helpers de webhook precisam de `node:crypto`.

Dúvidas de instalação: [fale com o suporte de integração](https://docs.sinnu.com.br/comunidade/ajuda.md).


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