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

# SDK TypeScript

> Um cliente de servidor para links, clientes, transações, checkout e validação de webhooks.

O `@sinnu-dev/sdk` reúne os recursos de integração em uma interface tipada para Node.js.

> [!NOTE]
>
> O pacote está publicado no npm; veja [instalação e disponibilidade](https://docs.sinnu.com.br/sdk/instalacao.md). Em projetos CommonJS (`require`), use a 0.2.1 ou superior; para `sinnu.customers`, `customer` inline em links e `maxPayments`, use a 0.3.0 ou superior. A API documentada é a de produção: não há ambiente de testes. Quem prefere não usar o SDK integra pela [API REST](https://docs.sinnu.com.br/inicio/primeiro-link.md).

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

const apiKey = process.env.SINNU_API_KEY;
if (!apiKey) throw new Error("Configure SINNU_API_KEY.");

const sinnu = new Sinnu({ apiKey });
const link = await sinnu.links.create({
  title: "Consultoria inicial",
  amountCents: 9900,
  methods: ["pix", "credit_card"],
});

const checkoutUrl = sinnu.checkout.url(link.slug);
```

## Recursos

| Recurso | Métodos | Guia |
| - | - | - |
| `sinnu.links` | `create`, `get`, `update`, `archive`, `list`, `listAll`, `transactions` | [Links](https://docs.sinnu.com.br/sdk/links.md) |
| `sinnu.customers` | `create`, `get`, `update`, `list`, `listAll` | [Clientes](https://docs.sinnu.com.br/sdk/clientes.md) |
| `sinnu.transactions` | `list`, `listAll`, `get`, `refund` | [Transações](https://docs.sinnu.com.br/sdk/transacoes.md) |
| `sinnu.checkout` | `url` | [Checkout](https://docs.sinnu.com.br/guias/checkout.md) |
| `sinnu.webhooks` | `constructEvent`, `verifySignature`, `computeSignature` | [Webhooks](https://docs.sinnu.com.br/sdk/webhooks.md) |
| `sinnu.http` | Cliente tipado de baixo nível | [Configuração](https://docs.sinnu.com.br/sdk/configuracao.md) |

O SDK não é um componente de interface. Use-o no servidor e entregue ao frontend apenas o que ele precisa exibir.

## O que esperar desta versão

Autenticação por chave, erros HTTP tipados e iteração por páginas estão implementados. Retentativas automáticas, timeout configurável no construtor e idempotência de criação não são opções nativas desta versão.

Os helpers de webhook usam `node:crypto`. Para o exemplo em Next.js, escolha o runtime Node.js.


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