Pular para o conteúdo principal
Ao terminar, a sua página mostra o checkout da sinnu como um elemento e reage quando o pagamento é aprovado. Leva poucos minutos se o recurso já estiver liberado para a sua empresa. Você precisa de um site servido por https://, de acesso ao painel sinnu como Titular ou Administrador da empresa e de um link de pagamento de venda avulsa. Os exemplos usam produção: concluir um pagamento gera uma cobrança real.
1

Peça a liberação

O Sinnu Elements é ativado pela sinnu para cada empresa. Se ainda não estiver, fale com o suporte de integração.
2

Cadastre o domínio do seu site

No painel, abra Configurações → Checkout embutido → Domínios permitidos e cadastre a origem exata da página que vai mostrar o elemento, por exemplo https://loja.exemplo.com.br.https://www.loja.exemplo.com.br é outra origem: cadastre as duas se o site responde nas duas. A mudança pode levar até um minuto para valer. As regras completas estão em segurança.
3

Pegue o slug do link

O slug é o código público no fim da URL do checkout: em https://pay.sinnu.com.br/abc12345, o slug é abc12345. Crie o link no painel ou pela API.
4

Monte o elemento

Escolha entre o arquivo pronto, via <script>, ou o pacote npm. Os dois têm a mesma API.Com <script>, sem bundler. O arquivo expõe window.SinnuElements:
HTML
  • link é o slug do link de pagamento; reference é o pedido no seu sistema, que volta na transação e no webhook.
  • completed serve só para a interface: o pedido é liberado pelo webhook.
  • error chega quando o elemento não montou ou não carregou em 15 s (load_timeout). A message já vem pronta para o comprador.
@0.1 recebe as correções da versão 0.1. Para fixar uma versão exata, use @0.1.1. Se preferir, sirva o arquivo dist/sinnu-elements.global.js do seu próprio domínio.Com npm, em projetos com bundler:
Terminal
elements-checkout.ts
Uso
O pacote pode ser importado no servidor (SSR) sem quebrar: só mount() precisa do navegador. Em React, use os componentes prontos.
5

Libere o elemento na sua Content Security Policy

Se o seu site envia o cabeçalho Content-Security-Policy, libere a página da sinnu em frame-src e, se usar o arquivo da CDN, a origem dele em script-src:
CSP
6

Libere o pedido pelo webhook

Configure o webhook e libere o pedido no evento assinado transaction.approved. O data.reference dele traz o reference com que o elemento foi montado. O evento completed serve só para a interface.

Se o elemento não aparecer

Em qualquer error, ofereça uma alternativa ao comprador, como um link para o checkout hospedado do mesmo link e pedido (https://pay.sinnu.com.br/abc12345?ref=pedido-123). O prazo de carregamento muda com a opção loadTimeoutMs. A tabela completa de códigos está em eventos e erros.

Elemento checkout

Opções, eventos e o que o comprador vê.

Elemento payment

Seus campos, seu botão e o confirm().