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

# Escolha sua integração

> Encontre o caminho adequado ao seu produto, à sua equipe e ao que você precisa automatizar.

| Você quer… | Comece por | O que precisa construir |
| - | - | - |
| Enviar uma cobrança sem programar | [Painel sinnu](https://app.sinnu.com.br) | Nada: crie e compartilhe o link. |
| Criar links a partir do seu sistema | [API REST](https://docs.sinnu.com.br/inicio/primeiro-link.md) | Uma chamada autenticada no servidor. |
| Abrir o checkout com dados do comprador preenchidos | [Links de pagamento](https://docs.sinnu.com.br/guias/links-de-pagamento.md#dados-do-comprador-no-checkout) | Objeto `customer` na criação do link (1 requisição) e `maxPayments` opcional. |
| Integrar em Node.js e TypeScript | [SDK](https://docs.sinnu.com.br/sdk/visao-geral.md) | Cliente de servidor e tratamento de erros; confira a distribuição disponível. |
| Adicionar um botão ao seu site | [Botão de pagamento](https://docs.sinnu.com.br/elements/botao-de-pagamento.md) | Botão que abre uma URL de checkout criada no servidor. |
| Receber dentro do seu site, sem redirecionar | [Sinnu Elements](https://docs.sinnu.com.br/elements/visao-geral.md) | Domínio cadastrado no painel e algumas linhas de JavaScript ou um componente React. |
| Liberar um serviço após o pagamento | [Webhooks](https://docs.sinnu.com.br/guias/webhooks.md) | Endpoint assinado e atualização idempotente do pedido. |
| Escrever a integração com um assistente de IA | [Documentação para IA](https://docs.sinnu.com.br/ia/documentacao-para-ia.md) | O `llms.txt` numa conversa ou o servidor MCP da documentação no seu editor. |

## O checkout é hospedado

Seu sistema define o valor e abre o checkout da sinnu. O comprador informa os dados de pagamento nesse checkout. Você não precisa criar um formulário de cartão para seguir os guias deste portal.

Com o [Sinnu Elements](https://docs.sinnu.com.br/elements/visao-geral.md), o mesmo checkout aparece dentro da sua página, num componente seguro servido pela sinnu. Os dados do cartão continuam fora do seu site.

## Uma chave por contexto de empresa

As operações da API usam a empresa vinculada à chave. Se o seu sistema atende mais de uma empresa, mantenha as credenciais e os registros separados por empresa.

## Antes da primeira cobrança

Confira a [autenticação](https://docs.sinnu.com.br/fundamentos/autenticacao.md), as [unidades dos valores](https://docs.sinnu.com.br/fundamentos/valores-e-status.md) e o [recebimento de eventos](https://docs.sinnu.com.br/guias/webhooks.md). Os exemplos usam a API de produção; o portal não fornece um ambiente público de testes.


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