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

# Paginação e erros

> Processe listas com memória controlada e diferencie falhas HTTP de falhas de transporte.

## Uma página

As listagens retornam `{ data, total, page, pageSize }`.

```ts TypeScript theme={null}
const page = await sinnu.transactions.list({ page: 1, pageSize: 20 });
console.log(page.data.length, page.total);
```

## Todos os resultados

```ts TypeScript theme={null}
for await (const transaction of sinnu.transactions.listAll({
  status: "approved",
  pageSize: 20,
})) {
  console.log(transaction.id, transaction.amount);
}
```

`listAll` começa na página 1 e busca as seguintes conforme a iteração avança. Use `list` quando precisar iniciar em uma página específica. Evite acumular uma listagem grande inteira na memória.

## Classes de erro

| Classe | Resposta |
| - | - |
| `SinnuAuthError` | `401` ou `403` |
| `SinnuValidationError` | `400` ou `422` |
| `SinnuNotFoundError` | `404` |
| `SinnuRateLimitError` | `429` |
| `SinnuError` | Demais falhas HTTP |

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

try {
  await sinnu.transactions.list({ page: 1 });
} catch (error) {
  if (error instanceof SinnuRateLimitError) {
    console.error("Aguarde:", error.response?.headers.get("Retry-After"));
  } else if (error instanceof SinnuError) {
    console.error(error.response?.status ?? error.statusCode, error.message);
  } else {
    // fetch pode lançar TypeError ou AbortError sem envolvê-los em SinnuError.
    console.error("Não foi possível concluir a comunicação.");
  }
}
```

`SinnuAuthError.statusCode` traz o status real da resposta: `401` para chave ausente, inválida ou expirada e `403` para chave sem permissão. `error.response?.status` continua disponível.

Nenhuma dessas classes executa retentativas automaticamente. Planeje a recuperação conforme a operação.


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