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

# Ajuda com sua integração

> Reúna o contexto necessário para investigar uma dúvida ou falha.

Envie sua dúvida para [suporte@sinnu.com.br](mailto:suporte@sinnu.com.br).

## Para dúvidas de implementação

Conte o resultado desejado, a linguagem ou framework e a página que você está seguindo. Se o problema for de instalação, inclua a versão do runtime e a origem do pacote.

## Para uma requisição que falhou

Use este modelo, removendo chaves e dados pessoais:

```text Modelo de atendimento theme={null}
Assunto: Integração — resumo do problema

Recurso: link / transação / webhook
Operação: método HTTP e caminho
Horário e fuso:
Status HTTP:
Identificador do recurso:
Resultado esperado:
Resultado observado:
Exemplo mínimo sem segredos:
```

Não envie `Authorization`, chave de API, segredo de webhook, dados de cartão ou um dump completo do cliente.

## Antes de abrir o chamado

| Problema | Confira primeiro |
| - | - |
| `npm install @sinnu-dev/sdk` retorna `404` | [Disponibilidade do SDK](https://docs.sinnu.com.br/sdk/instalacao.md). |
| Chamada não autentica | [Autenticação](https://docs.sinnu.com.br/fundamentos/autenticacao.md). |
| Valor parece cem vezes maior ou menor | [Unidades dos valores](https://docs.sinnu.com.br/fundamentos/valores-e-status.md). |
| Assinatura inválida | Corpo original e segredo em [webhooks](https://docs.sinnu.com.br/guias/webhooks.md). |
| Pagamento repetido na sua aplicação | [Processamento idempotente](https://docs.sinnu.com.br/guias/conciliacao.md). |

Para notificações operacionais pelo Discord, consulte a configuração de integrações no painel e peça ao suporte orientação sobre os eventos disponíveis para sua empresa.


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