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

# Configure o cliente

> Centralize a chave e as opções de transporte no seu servidor.

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

const apiKey = process.env.SINNU_API_KEY;
if (!apiKey) throw new Error("SINNU_API_KEY não foi configurada.");

export const sinnu = new Sinnu({ apiKey });
```

## Opções do construtor

| Opção | Obrigatória | Padrão | Uso |
| - | - | - | - |
| `apiKey` | Sim | — | Chave secreta da empresa. |
| `baseUrl` | Não | `https://api.sinnu.com.br` | URL base da API, sem acrescentar `/api`. |
| `checkoutBaseUrl` | Não | `https://pay.sinnu.com.br` | Base do construtor de URL de checkout. |
| `headers` | Não | `{}` | Headers adicionais. Não sobrescreva `Authorization` por acidente. |
| `fetch` | Não | `fetch` do runtime | Transporte customizado ou mock para testes. |

## Timeout de consulta

Não há uma propriedade `timeout` no construtor. Quando precisar limitar consultas, forneça um `fetch` próprio:

```ts TypeScript theme={null}
const sinnu = new Sinnu({
  apiKey,
  fetch: (input, init) => fetch(input, {
    ...init,
    signal: init?.signal ?? AbortSignal.timeout(10_000),
  }),
});
```

Se houver timeout em uma escrita, [confira o resultado antes de repetir](https://docs.sinnu.com.br/fundamentos/erros-e-limites.md).

## Acesso de baixo nível

`sinnu.http` expõe o cliente gerado do OpenAPI para chamadas customizadas (para clientes, prefira o recurso dedicado [`sinnu.customers`](https://docs.sinnu.com.br/sdk/clientes)). Use somente endpoints da [referência pública](https://docs.sinnu.com.br/api/introducao.md); a presença de um tipo no arquivo gerado não torna uma rota interna parte do contrato para integradores.

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

const customers = await unwrap(
  sinnu.http.GET("/api/customers/", {
    params: { query: { page: 1, pageSize: 20 } },
  }),
);
```


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