# sinnu developers > Construa com a sinnu. Guias de integração, SDK TypeScript, componentes e referência da API de pagamentos. > ## 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. - [Documentação sinnu](https://docs.sinnu.com.br/index.md): Integre pagamentos, desenvolva com TypeScript e construa a interface do seu produto. - [Crie seu primeiro link](https://docs.sinnu.com.br/inicio/primeiro-link.md): Envie uma requisição do seu servidor e obtenha um checkout para receber por Pix ou cartão. - [Escolha sua integração](https://docs.sinnu.com.br/inicio/escolha-sua-integracao.md): Encontre o caminho adequado ao seu produto, à sua equipe e ao que você precisa automatizar. - [Autenticação](https://docs.sinnu.com.br/fundamentos/autenticacao.md): Use uma chave secreta de API no servidor para operar os recursos de uma empresa. - [Valores, identificadores e status](https://docs.sinnu.com.br/fundamentos/valores-e-status.md): Interprete cada campo pela sua unidade e pelo recurso que o retornou. - [Erros e limites](https://docs.sinnu.com.br/fundamentos/erros-e-limites.md): Trate falhas sem perder o contexto da operação nem repetir uma ação financeira por engano. - [Links de pagamento](https://docs.sinnu.com.br/guias/links-de-pagamento.md): Crie uma oferta com valor definido e gerencie sua disponibilidade. - [Abra o checkout](https://docs.sinnu.com.br/guias/checkout.md): Leve o comprador da sua interface ao checkout hospedado da sinnu. - [Rastreie a origem das vendas](https://docs.sinnu.com.br/guias/rastreamento.md): Ligue os pixels de Meta, TikTok e Google Ads ao checkout e saiba de qual campanha veio cada venda. - [Receba webhooks](https://docs.sinnu.com.br/guias/webhooks.md): Valide a origem de cada evento e confirme o pagamento no seu servidor. - [Concilie pagamentos](https://docs.sinnu.com.br/guias/conciliacao.md): Mantenha seu pedido consistente com a transação, inclusive quando eventos chegam mais de uma vez. - [Receba avisos no Discord](https://docs.sinnu.com.br/guias/discord.md): Conecte um canal da sua equipe às notificações de transação pelo painel sinnu. - [Documentação para assistentes de IA](https://docs.sinnu.com.br/ia/documentacao-para-ia.md): Leve este portal para o seu assistente: em Markdown, pelo llms.txt, pelo servidor MCP da documentação ou como skill. - [Servidor MCP](https://docs.sinnu.com.br/servidor-mcp/visao-geral.md): Conecte um assistente de IA à sua conta sinnu pelo login, autorizando a conexão no painel, ou com a chave de API da empresa. - [Conecte o Claude ao servidor MCP](https://docs.sinnu.com.br/servidor-mcp/conectar-claude.md): Adicione o servidor MCP da sinnu como conector personalizado no Claude, entre com a sua conta e autorize a conexão no painel. - [Conecte o ChatGPT ao servidor MCP](https://docs.sinnu.com.br/servidor-mcp/conectar-chatgpt.md): Adicione o servidor MCP da sinnu como servidor MCP personalizado no ChatGPT, entre com a sua conta e autorize a conexão no painel. - [Conecte o Cursor, o VS Code e outros clientes](https://docs.sinnu.com.br/servidor-mcp/conectar-outros.md): Adicione o servidor MCP da sinnu no Cursor ou no VS Code só com o endereço e autorize pelo login, ou use a chave de API num cliente sem login. - [Conexões autorizadas](https://docs.sinnu.com.br/servidor-mcp/conexoes-autorizadas.md): Veja e revogue as conexões que assistentes de IA têm com a sua empresa pelo login, troque o nível de acesso e saiba quando uma conexão termina sozinha. - [Ferramentas do servidor MCP](https://docs.sinnu.com.br/servidor-mcp/ferramentas.md): O que cada ferramenta faz, o escopo que exige, os parâmetros principais e os cuidados ao usar. - [Confirme saques com app autenticador](https://docs.sinnu.com.br/seguranca/app-autenticador.md): Use um código do seu celular para confirmar saques no painel, sem esperar o e-mail chegar. - [SDK TypeScript](https://docs.sinnu.com.br/sdk/visao-geral.md): Um cliente de servidor para links, clientes, transações, checkout e validação de webhooks. - [Instalação e disponibilidade](https://docs.sinnu.com.br/sdk/instalacao.md): Como instalar o SDK publicado no npm e o que ele exige do ambiente. - [Configure o cliente](https://docs.sinnu.com.br/sdk/configuracao.md): Centralize a chave e as opções de transporte no seu servidor. - [Links](https://docs.sinnu.com.br/sdk/links.md): Crie, consulte, atualize e arquive links de pagamento com o SDK. - [Clientes](https://docs.sinnu.com.br/sdk/clientes.md): Cadastre, consulte, atualize e liste clientes da empresa com o SDK. - [Transações](https://docs.sinnu.com.br/sdk/transacoes.md): Consulte pagamentos, filtre resultados e solicite um estorno total. - [Valide webhooks com o SDK](https://docs.sinnu.com.br/sdk/webhooks.md): Receba o corpo original, confira a assinatura e persista o evento antes de responder. - [Paginação e erros](https://docs.sinnu.com.br/sdk/paginacao-e-erros.md): Processe listas com memória controlada e diferencie falhas HTTP de falhas de transporte. - [Integre com Next.js](https://docs.sinnu.com.br/sdk/nextjs.md): Mantenha o SDK no servidor e passe apenas a URL pública para sua interface. - [Sinnu Elements](https://docs.sinnu.com.br/elements/visao-geral.md): Tudo o que você precisa para receber com Pix e cartão no seu site: elementos seguros da sinnu para o pagamento e componentes para a interface em volta deles. - [Início rápido](https://docs.sinnu.com.br/elements/inicio-rapido.md): Do link de pagamento ao primeiro pagamento com Pix ou cartão dentro do seu site. - [Exemplo completo: propostas pagas pelo WhatsApp](https://docs.sinnu.com.br/elements/exemplo-propostas.md): Um app Next.js de propostas que cria um link por proposta, cobra no elemento payment e libera o pedido só pelo webhook. - [Elemento checkout](https://docs.sinnu.com.br/elements/checkout.md): O formulário completo da sinnu dentro do seu site: resumo, comprador, Pix ou cartão e o botão de pagar. - [Elemento payment](https://docs.sinnu.com.br/elements/pagamento.md): Só Pix e cartão dentro do elemento: sua página coleta o comprador, mostra o botão e chama confirm(). - [Sinnu Elements em React](https://docs.sinnu.com.br/elements/react.md): Os componentes SinnuCheckout e SinnuPayment, com confirm() pela ref. - [Botão de pagamento](https://docs.sinnu.com.br/elements/botao-de-pagamento.md): Uma âncora acessível para abrir o checkout a partir de um slug público. - [Status de pagamento](https://docs.sinnu.com.br/elements/status-de-pagamento.md): Mostre o estado recebido do servidor sem depender apenas de cor. - [Aparência](https://docs.sinnu.com.br/elements/aparencia.md): As variáveis de cor, cantos e fonte que o Sinnu Elements aceita, e os limites de cada uma. - [Fundamentos visuais](https://docs.sinnu.com.br/elements/fundamentos-visuais.md): Cor, tipografia e hierarquia para interfaces claras no ecossistema sinnu. - [Acessibilidade nas interfaces](https://docs.sinnu.com.br/elements/acessibilidade.md): Faça o fluxo de pagamento funcionar com teclado, leitura assistiva e diferentes tamanhos de tela. - [Eventos e erros](https://docs.sinnu.com.br/elements/eventos.md): Referência dos eventos do Sinnu Elements, dos códigos de failed e error e da classe SinnuElementsError. - [Segurança do Sinnu Elements](https://docs.sinnu.com.br/elements/seguranca.md): Domínios permitidos, o que fica fora do seu site e como liberar o pedido sem confiar no navegador. - [Referência da API](https://docs.sinnu.com.br/api/introducao.md): Consulte o contrato público de links de pagamento, clientes e transações. - [Liste links de pagamento](https://docs.sinnu.com.br/api/links/listar.md): Consulte os links da empresa com paginação. - [Crie um link de pagamento](https://docs.sinnu.com.br/api/links/criar.md): Defina o preço e os métodos de pagamento da sua oferta. - [Consulte um link](https://docs.sinnu.com.br/api/links/consultar.md): Busque um link pelo identificador retornado na criação. - [Atualize um link](https://docs.sinnu.com.br/api/links/atualizar.md): Altere os campos de um link da empresa. - [Arquive um link](https://docs.sinnu.com.br/api/links/arquivar.md): Retire um link de circulação. - [Liste as transações de um link](https://docs.sinnu.com.br/api/links/transacoes.md): Encontre os pagamentos associados a um link. - [Liste transações](https://docs.sinnu.com.br/api/transacoes/listar.md): Consulte os pagamentos da empresa com filtros e paginação. - [Consulte uma transação](https://docs.sinnu.com.br/api/transacoes/consultar.md): Confira o estado atual de um pagamento pelo identificador. - [Estorne uma transação](https://docs.sinnu.com.br/api/transacoes/estornar.md): Solicite uma devolução total de um pagamento. - [Liste clientes](https://docs.sinnu.com.br/api/clientes/listar.md): Consulte os clientes da empresa autenticada. - [Crie um cliente](https://docs.sinnu.com.br/api/clientes/criar.md): Cadastre os dados de um cliente na empresa. - [Consulte um cliente](https://docs.sinnu.com.br/api/clientes/consultar.md): Busque um cliente pelo identificador. - [Atualize um cliente](https://docs.sinnu.com.br/api/clientes/atualizar.md): Altere parcialmente os dados de um cliente. - [Construa junto com a sinnu](https://docs.sinnu.com.br/comunidade/visao-geral.md): Encontre exemplos, compartilhe o contexto da sua integração e ajude a melhorar a documentação. - [Exemplos por tarefa](https://docs.sinnu.com.br/comunidade/exemplos.md): Vá direto ao código que resolve a próxima etapa da sua integração. - [Ajuda com sua integração](https://docs.sinnu.com.br/comunidade/ajuda.md): Reúna o contexto necessário para investigar uma dúvida ou falha. - [Melhore esta documentação](https://docs.sinnu.com.br/comunidade/contribuir.md): Ajude a tornar cada instrução mais precisa, útil e fácil de seguir. ## OpenAPI Specs - [openapi](/api/openapi.yaml) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.