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

# Exemplos por tarefa

> Vá direto ao código que resolve a próxima etapa da sua integração.

| Sua tarefa | Exemplo | Resultado |
| - | - | - |
| Fazer a primeira chamada | [Primeiro link com cURL](https://docs.sinnu.com.br/inicio/primeiro-link.md) | Um link e um slug para abrir o checkout. |
| Criar um link em TypeScript | [SDK de links](https://docs.sinnu.com.br/sdk/links.md) | Um objeto `PaymentLink` tipado. |
| Usar Next.js | [Integração no servidor](https://docs.sinnu.com.br/sdk/nextjs.md) | Serviço de criação separado da interface. |
| Receber eventos | [Handler de webhook](https://docs.sinnu.com.br/sdk/webhooks.md) | Validação antes da persistência. |
| Acompanhar pagamentos | [Conciliação](https://docs.sinnu.com.br/guias/conciliacao.md) | Atualização idempotente do pedido. |
| Percorrer transações | [Paginação](https://docs.sinnu.com.br/sdk/paginacao-e-erros.md) | Processamento progressivo da listagem. |
| Abrir o checkout em React | [Botão de pagamento](https://docs.sinnu.com.br/elements/botao-de-pagamento.md) | Navegação sem chave no navegador. |
| Embutir o checkout no seu site | [Início rápido do Sinnu Elements](https://docs.sinnu.com.br/elements/inicio-rapido.md) | Pix e cartão num elemento seguro da sinnu, sem chave no navegador. |
| Ver uma integração completa | [Exemplo: propostas pagas pelo WhatsApp](https://docs.sinnu.com.br/elements/exemplo-propostas.md) | App Next.js que cria um link por proposta, cobra no elemento `payment` e libera pelo webhook. |
| Usar seus campos e seu botão | [Elemento payment](https://docs.sinnu.com.br/elements/pagamento.md) | `confirm()` com o comprador do seu formulário. |
| Exibir o estado | [Status de pagamento](https://docs.sinnu.com.br/elements/status-de-pagamento.md) | Mensagem acessível e valor formatado. |

## Convenções dos exemplos

Valores, nomes, e-mails e identificadores são fictícios. Substitua placeholders pelo recurso retornado à sua empresa. Os exemplos com SDK pressupõem que você já [obteve o pacote](https://docs.sinnu.com.br/sdk/instalacao.md).

Uma demonstração de interface não simula um pagamento. As chamadas para `api.sinnu.com.br` usam produção.


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