pay.sinnu.com.br, e a sua página conversa com ele por eventos. Preço, parcelas, juros e meios de pagamento continuam vindo do link de pagamento, como no checkout hospedado.
O checkout hospedado (https://pay.sinnu.com.br/{slug}) continua sendo o caminho mais simples: um link ou redirecionamento, sem nada para instalar. Use o Sinnu Elements quando o pagamento precisar acontecer dentro da sua página.
Escolha a peça
O Sinnu Elements reúne as peças para cobrar no seu site. Os elementos são componentes seguros servidos pela sinnu: recebem o pagamento dentro da sua página. Os componentes do seu site ficam no seu código, em volta deles: abrir o checkout e mostrar o resultado.
Elemento checkout: o formulário completo

Elemento payment: só os meios de pagamento
@sinnu-dev/elements, com componentes React em @sinnu-dev/elements/react. O botão e o status são receitas React para copiar e adaptar: não há pacote para instalar, e nenhum deles recebe chave de API, segredo de webhook ou dado de cartão. A aparência ajusta as cores dos elementos; os fundamentos visuais e a acessibilidade valem para tudo.
Nos elementos, o QR Code do Pix, o desafio de autenticação do cartão (3DS) e a confirmação do pagamento aparecem dentro do elemento. Veja como o 3DS entra. O elemento ocupa a largura do contêiner e ajusta a altura sozinho.
O que a sinnu garante
O cartão não passa pela sua página
Número, validade e CVV só existem dentro do elemento, servido por
pay.sinnu.com.br. Seu site não tem acesso a eles, o que permite que sua página se enquadre no questionário SAQ A do PCI DSS.Nenhum segredo no navegador
O elemento usa só o slug do link, que é público: o mesmo código da URL do checkout. A chave
sk_live_... fica no seu servidor.Só nos seus domínios
O elemento só abre nos domínios cadastrados para a sua empresa. As mensagens entre a página e o elemento são conferidas nas duas pontas.
As mesmas regras do checkout
A cobrança é a do checkout hospedado: mesmos valores, mesmas parcelas e as mesmas verificações antifraude.
O que você precisa
- Sinnu Elements liberado para a sua empresa. O recurso é ativado pela sinnu. Fale com o suporte de integração para liberar.
- O domínio do seu site cadastrado no painel, em Configurações → Checkout embutido → Domínios permitidos: a origem exata, como
https://loja.exemplo.com.br. - Um link de pagamento de venda avulsa. Crie no painel ou pela API e guarde o
slug. - Um webhook configurado. O pedido é liberado pelo evento assinado
transaction.approved, não pelo navegador. Veja webhooks.
Como um pagamento acontece
1
Seu servidor escolhe o link e o pedido
Ele entrega à página o
slug do link e a referência do pedido no seu sistema. Nada de chave de API vai junto.2
Sua página monta o elemento
O loader
@sinnu-dev/elements monta o elemento com o slug, a referência e a origem da sua página.3
O comprador paga dentro do elemento
No Pix, o QR Code aparece no elemento até o pagamento ou o vencimento. No cartão, a aprovação aparece na hora.
4
O seu servidor libera o pedido
O evento
completed atualiza a sua interface. A liberação vem do webhook transaction.approved, que traz a mesma referência do pedido.Limitações da v1
- Só venda avulsa. Um link só de assinatura não monta: o elemento responde
errorcomunsupported_link. Um link que também aceita compra avulsa abre só nela. - Só pt-BR. A opção
localeaceita apenas"pt-BR". - Sem Apple Pay e Google Pay dentro do elemento.
- O valor vem do link. Uma sessão com valor definido pelo seu servidor na hora da compra virá em uma versão futura.
- Pixels de rastreamento configurados no link não rodam dentro do elemento.
- Pix Automático em breve.
O pacote
O loader é o pacote@sinnu-dev/elements: zero dependências, ESM e CommonJS, tipos TypeScript e componentes React em @sinnu-dev/elements/react. Ele também tem um arquivo pronto para usar com <script>, sem bundler. A versão atual e o histórico ficam na página do pacote no npm.
Início rápido
Do link ao primeiro pagamento embutido.
Exemplo completo
Um app de propostas que cobra pelo elemento payment.
Segurança
Domínios permitidos e liberação do pedido.