Pular para o conteúdo principal
O elemento checkout coloca o checkout inteiro na sua página, num componente seguro da sinnu. O comprador vê o resumo do produto, preenche os dados dele, escolhe Pix ou cartão e paga, sem sair do seu site. Você escreve só a montagem e as reações aos eventos.
Elemento checkout montado numa página de loja: resumo do pedido, dados do comprador, Pix ou cartão e o botão de pagar.
Antes, confira os requisitos: recurso liberado, domínio cadastrado e um link de venda avulsa.

Código

elements-checkout.ts
Contêiner
O elemento ocupa 100% da largura do contêiner. A altura começa em 120 px e acompanha o conteúdo pelo evento resize, sem código seu. Limite a largura pelo contêiner, por exemplo com max-width: 560px.

Opções de createElements

Uma opção inválida lança SinnuElementsError com invalid_config na hora, com uma mensagem que diz o que corrigir. createElements não toca no DOM: pode rodar no servidor. Os elementos criados por uma instância compartilham link, referência e aparência. Para outro pedido, crie outra instância.

Métodos

Montar duas vezes sem unmount() lança invalid_config. Numa aplicação de página única, chame elements.destroy() quando a tela do pagamento sair.

Eventos que importam aqui

Os payloads e todos os códigos estão em eventos e erros.

O que o comprador vê

Pix gerado dentro do elemento checkout: QR Code, contagem até o vencimento e o botão de copiar o código.
  • Pix: o QR Code e o copia e cola aparecem dentro do elemento, com a contagem até o vencimento. Quando o pagamento é confirmado, o elemento mostra a aprovação e você recebe completed.
  • Cartão: parcelas e juros seguem o link. Se o emissor recusar a primeira tentativa e a autenticação do banco (3DS) estiver disponível, o desafio abre dentro do elemento. Veja como o 3DS entra. Aprovado, o elemento mostra a confirmação e você recebe completed.
  • Recusa: o comprador vê o motivo no formulário e pode tentar outro cartão.
  • Comprador vinculado: quando o link possui cliente vinculado (customer ou linkedCustomer), nome, e-mail, telefone (se informado) e CPF/CNPJ mascarado já abrem preenchidos, com opção de alterar.
  • Link pausado: o elemento mostra que o pagamento está indisponível.
O elemento não navega. O redirectUrl do link vale para o checkout hospedado; no Sinnu Elements, quem decide a próxima tela é a sua página, no evento completed.
completed roda no navegador do comprador. Use para a interface e libere o pedido pelo webhook transaction.approved ou consultando a transação no seu servidor. Veja segurança.

Só os meios de pagamento

Use o elemento payment com o seu formulário.

Em React

O mesmo elemento como componente.