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

# Aparência

> As variáveis de cor, cantos e fonte que o Sinnu Elements aceita, e os limites de cada uma.

Ajuste o elemento à identidade do seu site com seis variáveis. Elas valem para todos os elementos criados pela mesma instância de `createElements`.

```ts TypeScript theme={null}
import { createElements } from "@sinnu-dev/elements";

const elements = createElements({
  link: "abc12345",
  appearance: {
    variables: {
      colorPrimary: "#C6F211",
      colorBackground: "#FFFFFF",
      colorText: "#111111",
      colorDanger: "#D92D20",
      borderRadius: "8px",
      fontFamily: "system",
    },
  },
});
```

![Elemento checkout com a aparência padrão da sinnu.](https://mintcdn.com/sinnu/G5P73YDmE1l48Zth/images/elements/checkout-inicio.png?fit=max\&auto=format\&n=G5P73YDmE1l48Zth\&q=85\&s=f83dab92d073c6351347e3cbe5d74eae)

Padrão

![O mesmo elemento checkout com a cor da marca, cantos mais arredondados e a fonte Inter.](https://mintcdn.com/sinnu/G5P73YDmE1l48Zth/images/elements/aparencia-marca.png?fit=max\&auto=format\&n=G5P73YDmE1l48Zth\&q=85\&s=64a41ab9b076fdba7a60db8ae8d36495)

Com a cor, os cantos e a fonte da marca

## Variáveis

| Variável | Valores aceitos | Onde aparece |
| - | - | - |
| `colorPrimary` | `#RGB` ou `#RRGGBB` | Botão de pagar, destaques e anel de foco. O texto sobre essa cor fica preto ou branco, o que tiver mais contraste. |
| `colorBackground` | `#RGB` ou `#RRGGBB` | Fundo do elemento e dos painéis. |
| `colorText` | `#RGB` ou `#RRGGBB` | Texto principal. |
| `colorDanger` | `#RGB` ou `#RRGGBB` | Mensagens de erro. |
| `borderRadius` | Inteiro de `0px` a `24px` | Cantos de campos, botões e painéis. |
| `fontFamily` | `system`, `inter` ou `geist` | Fonte do elemento. `system` usa a fonte do sistema do comprador. |

Sem uma variável, o elemento usa o visual padrão do checkout da sinnu.

## Limites

* **Só esses formatos.** Nomes de cor (`red`), `rgb()`, transparência, unidades diferentes de `px` e valores decimais não são aceitos.
* **Valor inválido é ignorado**, sem derrubar o elemento: o resto da aparência continua valendo. Uma variável desconhecida também é ignorada.
* **Nada vira CSS.** Não é possível injetar seletores, classes ou folhas de estilo no elemento: ele aplica só essas seis variáveis, depois de validá-las de novo.
* **A fonte vem da sinnu.** Não dá para carregar uma fonte própria dentro do elemento.

Para conferir o que será aplicado, use `sanitizeAppearance`: ela devolve só as variáveis válidas.

```ts TypeScript theme={null}
import { sanitizeAppearance } from "@sinnu-dev/elements";

sanitizeAppearance({ variables: { colorPrimary: "lime", borderRadius: "12px" } });
// { borderRadius: "12px" }
```

## Mudar a aparência

A aparência vai na URL do elemento. Para mudar, crie outra instância e monte o elemento de novo; o que o comprador preencheu se perde. Em React, mudar o conteúdo de `appearance` recria o elemento.

Garanta contraste suficiente entre `colorText` e `colorBackground`. Veja também os [fundamentos visuais](https://docs.sinnu.com.br/elements/fundamentos-visuais.md) e a [acessibilidade](https://docs.sinnu.com.br/elements/acessibilidade.md).


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