Pular para o conteúdo principal
O Propostiva é o app de exemplo do Sinnu Elements: o sistema de propostas de uma agência fictícia. A agência monta a proposta, envia o link pelo WhatsApp, e o cliente paga com Pix ou cartão na própria página da proposta, pelo elemento payment. Serve de modelo para qualquer negócio que vende produto, serviço ou software e quer receber dentro do próprio site. O endereço do ambiente de demonstração (sandbox) é https://propostiva.sinnu.cloud: um domínio fora da sinnu, como o site de um cliente. Nenhum pagamento feito lá é real.

Como funciona

1

A agência cria a proposta

O servidor do app cria um link de pagamento para a proposta, com o total, o máximo de parcelas e quem paga os juros. Junto nasce um pedido no banco do app; o id dele é a reference.
2

A agência envia pelo WhatsApp

A mensagem leva o endereço da página da proposta. O endereço tem um token aleatório e nenhum dado pessoal.
3

O cliente paga na página da proposta

A página coleta nome, e-mail, celular e CPF ou CNPJ e chama confirm({ customer }). O QR Code do Pix, os campos do cartão e o desafio do banco ficam dentro do elemento.
4

O webhook libera o pedido

O evento assinado transaction.approved marca o pedido como pago. A página, que consultava o servidor do app desde o completed, mostra a confirmação. O link é arquivado para ninguém pagar de novo por ele.

Onde está cada parte

O que é integração com a sinnu fica separado do produto fictício. Copie a integração e troque o resto pelo seu sistema. O valor de cada proposta é diferente, e o elemento cobra pelo link. Por isso o app cria um link para cada proposta:
TypeScript
A chave precisa dos escopos links:write, para criar e arquivar o link, e transactions:read, para conferir a venda no webhook. Veja escopos.

Libere só pelo webhook

O completed e o resultado do confirm() rodam no navegador do cliente. No exemplo, eles só mudam a tela para “confirmando”. Quem marca o pedido como pago é o webhook, depois de quatro conferências:
TypeScript
  • data.amount vem em reais e inclui os juros quando o cliente paga o parcelamento. Por isso o exemplo compara productAmount, o preço antes dos juros, em centavos. Veja valores e status.
  • A mesma entrega pode chegar mais de uma vez, e fora de ordem. No banco, a marcação é um UPDATE ... WHERE id = ? AND status = 'pending', conferindo as linhas afetadas.
  • Transação ainda pending na API: responda 5xx. Com 200, a sinnu daria o evento por entregue.
  • Arquive o link depois de pago (sinnu.links.archive). O exemplo faz isso depois de responder ao webhook, para a resposta sair rápido.

A tela de pagamento

  • Confirmando até o servidor dizer que está pago. Depois do completed, a página consulta o servidor do app até ele responder que o pedido está pago.
  • Volta do app do banco. Quem paga Pix pelo celular sai para o app do banco e volta. Quando a aba fica visível de novo, a página consulta na hora.
  • Recarregar não cobra de novo. Entre o completed e o webhook, o pedido ainda está “aguardando”. O exemplo guarda o transactionId na aba e, se o cliente recarregar, a tela volta para “confirmando” em vez de mostrar o formulário outra vez.
  • Falhas. A tela decide pelo retryable de cada failed. Um unknown com retryable: false pede para conferir antes de cobrar de novo. Veja eventos e erros.

O que configurar

  1. Sinnu Elements liberado para a empresa. Fale com o suporte de integração.
  2. A origem exata do site em Domínios permitidos, em Configurações → Checkout embutido. https://www.loja.exemplo.com.br é outra origem que https://loja.exemplo.com.br. Veja domínios permitidos.
  3. Um webhook assinando transaction.*, apontando para a rota do app. Veja webhooks.
  4. A Content Security Policy do site com o checkout em frame-src. O exemplo usa a variante simples, com 'unsafe-inline' em script-src. Em produção, prefira a variante com nonce.
  5. reference e endereços sem dado pessoal. Use o id do pedido e um token aleatório, nunca e-mail, CPF ou telefone.

Elemento payment

O confirm() com o comprador do seu formulário.

Segurança

Domínios permitidos, 3DS e liberação do pedido.