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

# Status de pagamento

> Mostre o estado recebido do servidor sem depender apenas de cor.

## Prévia

<fieldset><legend>Explore os estados</legend></fieldset>

CONSULTORIA INICIAL / EXEMPLO

R\$ 99,00

Os estados acima são uma demonstração local. Nenhuma requisição de pagamento é executada.

## Código

```tsx payment-status.tsx theme={null}
const labels: Record<string, string> = {
  approved: "Pagamento aprovado",
  pending: "Aguardando pagamento",
  refused: "Pagamento não aprovado",
  refunded: "Pagamento estornado",
  chargeback: "Pagamento contestado",
};

type PaymentStatusProps = {
  status: string;
  amountCents: number;
};

export function PaymentStatus({ status, amountCents }: PaymentStatusProps) {
  if (!Number.isSafeInteger(amountCents) || amountCents < 0) {
    throw new Error("Use um valor não negativo em centavos.");
  }
  const label = labels[status] ?? "Status a confirmar";
  const amount = new Intl.NumberFormat("pt-BR", {
    style: "currency",
    currency: "BRL",
  }).format(amountCents / 100);

  return (
    <div className="sinnu-payment-status" role="status" aria-live="polite" aria-atomic="true">
      <span>{label}</span>
      <strong>{amount}</strong>
    </div>
  );
}
```

## Propriedades

| Prop | Tipo | Descrição |
| - | - | - |
| `status` | `string` | Status da API de transações. Valores desconhecidos exibem “Status a confirmar”. |
| `amountCents` | `number` | Inteiro não negativo em centavos. |

```tsx Uso theme={null}
<PaymentStatus
  status={transaction.status}
  amountCents={transaction.amount}
/>
```

## De onde vêm os dados

Seu servidor consulta a transação e retorna o estado necessário à interface. Não conecte este componente diretamente ao corpo do webhook: nele, `amount` está em reais e a aprovação usa `paid`.

O componente anuncia mudanças de texto com `role="status"` e `aria-live="polite"`. Mantenha-o montado durante as atualizações para que tecnologias assistivas recebam a mudança.


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