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

# Crie seu primeiro link

> Envie uma requisição do seu servidor e obtenha um checkout para receber por Pix ou cartão.

Ao terminar, você terá o `id` do link e uma URL no formato `https://pay.sinnu.com.br/{slug}`.

Você precisa de uma conta sinnu habilitada para vender, de uma chave de API da empresa e de um terminal com cURL. A URL usada neste guia é de produção: concluir um pagamento gera uma cobrança real.

**1. Gere sua chave de API**

Abra o [painel sinnu](https://app.sinnu.com.br), selecione a empresa e acesse **Chave de API**. Habilite o escopo `links:write` e guarde a chave no ambiente do servidor. Veja os [escopos disponíveis](https://docs.sinnu.com.br/fundamentos/autenticacao.md#escolha-os-escopos).

```bash Terminal theme={null}
export SINNU_API_KEY='SUA_CHAVE_SECRETA'
```

Substitua o valor pela chave `sk_live_...`. Ela não deve aparecer em código do navegador.

**2. Crie o link**

Neste exemplo, `9900` representa **R\$ 99,00**. O preço é definido no servidor.

```bash Terminal theme={null}
curl --fail-with-body --request POST \
  'https://api.sinnu.com.br/api/payment-links' \
  --header "Authorization: Bearer $SINNU_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "title": "Consultoria inicial",
    "priceMode": "fixed",
    "amountCents": 9900,
    "methods": ["pix", "credit_card"],
    "maxInstallments": 1
  }'
```

O endpoint de links não termina com `/`. Copie o caminho como está.

**3. Abra o checkout**

Na resposta, guarde `id` para gerenciar o link e `slug` para montar a URL pública:

```text URL do checkout theme={null}
https://pay.sinnu.com.br/SLUG_RETORNADO
```

Criar o link não confirma um pagamento. O comprador precisa concluir o checkout.

**4. Receba a confirmação**

Configure um endpoint HTTPS de webhook e assine o evento `transaction.approved`. [Valide a assinatura](https://docs.sinnu.com.br/guias/webhooks.md) antes de atualizar seu pedido.

O redirecionamento do navegador serve para navegação; a confirmação vem do servidor.

## Se a chamada falhar

| Resposta | Próximo passo |
| - | - |
| `401` ou `403` | Confira a chave, a empresa e as permissões. |
| `400` ou `422` | Leia os erros de campo e confira `amountCents` e `methods`. |
| `429` | Aguarde o intervalo informado em `Retry-After`. |
| Timeout | Consulte os links antes de repetir a criação. |

> [card] [Personalize o link](https://docs.sinnu.com.br/guias/links-de-pagamento.md)
>
> Métodos, parcelamento e ciclo de vida.

> [card] [Use TypeScript](https://docs.sinnu.com.br/sdk/instalacao.md)
>
> Disponibilidade e instalação do SDK.


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