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

# Referência da API

> Consulte o contrato público de links de pagamento, clientes e transações.

Todas as chamadas desta referência usam a URL base:

```text Produção theme={null}
https://api.sinnu.com.br
```

Autentique no servidor com `Authorization: Bearer SUA_CHAVE_SECRETA`. O contexto de empresa vem da chave.

> [card] [Links de pagamento](https://docs.sinnu.com.br/api/links/criar.md)
>
> Crie a oferta e obtenha o slug do checkout.

> [card] [Transações](https://docs.sinnu.com.br/api/transacoes/listar.md)
>
> Consulte o resultado de cada pagamento.

> [card] [Clientes](https://docs.sinnu.com.br/api/clientes/listar.md)
>
> Gerencie os clientes da empresa.

> [card] [Eventos](https://docs.sinnu.com.br/guias/webhooks.md)
>
> Receba mudanças no seu servidor.

## Convenções

* **Links** usam caminhos sem barra final, como `/api/payment-links`.
* **Transações e clientes** usam barra final, como `/api/transactions/`.
* **Listas** usam paginação com `page` e `pageSize`.
* **Valores** dependem do recurso. Confira [a tabela de unidades](https://docs.sinnu.com.br/fundamentos/valores-e-status.md).

## Contrato legível por ferramentas

[Baixe o OpenAPI público](https://docs.sinnu.com.br/api/openapi.yaml) para importar em ferramentas de desenvolvimento. Esta referência contém a superfície para integradores; rotas administrativas não fazem parte dela.

Os exemplos são copiáveis. O envio interativo de requisições está desativado neste portal, pois a URL documentada é de produção.


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