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

# Valores, identificadores e status

> Interprete cada campo pela sua unidade e pelo recurso que o retornou.

## Dinheiro: confira a unidade do campo

Os contratos atuais não usam uma única unidade em todas as superfícies.

| Contexto | Campo | Unidade | R\$ 99,00 |
| - | - | - | - |
| Link de pagamento | `amountCents` | Centavos, inteiro | `9900` |
| Consulta `/api/transactions/` | `amount`, `net` e decomposição de taxas | Centavos, inteiro | `9900` |
| Webhook `transaction.*` | `data.amount` | Reais | `99.0` |
| Transações de um link | `amount` | Reais | `99.0` |

> [!WARNING]
>
> Não aplique a regra “todo valor está em centavos” ao webhook. Para conciliação, consulte a transação pela API e compare valores na mesma unidade.

Use inteiros em centavos na sua aplicação. Ao receber valores decimais em reais, converta com uma estratégia decimal apropriada antes de calcular ou comparar dinheiro.

## Status dependem da superfície

| Situação | API de transações | Corpo do webhook | Evento |
| - | - | - | - |
| Pagamento aprovado | `approved` | `paid` | `transaction.approved` |
| Pagamento recusado | `refused` | `refused` ou `declined` | `transaction.declined` |
| Estorno | `refunded` | `refunded` | `transaction.refunded` |
| Chargeback | `chargeback` | `chargedback` | `transaction.chargeback` |

O nome do evento e o status do corpo não são o mesmo campo. Preserve valores desconhecidos para investigar mudanças do contrato; não os converta automaticamente em “aprovado”.

## Identificadores

* **`link.id`** identifica o link nas operações de consulta, edição e arquivamento.
* **`link.slug`** compõe a URL pública do checkout.
* **`transaction.id`** identifica um pagamento. Um link pode ter várias transações.
* **`data.id`**, em eventos `transaction.*`, identifica a transação relacionada.

Guarde a relação entre o seu pedido e os identificadores retornados. Não use valor, e-mail ou nome como chave única de um pagamento.

## Datas

Leia timestamps em ISO 8601 respeitando o fuso informado. Armazene uma referência consistente, como UTC, e converta para o fuso do usuário na exibição.


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