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 O pacote pode ser importado no servidor (SSR) sem quebrar: só
<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.completedserve só para a interface: o pedido é liberado pelo webhook.errorchega quando o elemento não montou ou não carregou em 15 s (load_timeout). Amessagejá 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
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().