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.Um link por proposta
O valor de cada proposta é diferente, e o elemento cobra pelo link. Por isso o app cria um link para cada proposta:TypeScript
links:write, para criar e arquivar o link, e transactions:read, para conferir a venda no webhook. Veja escopos.
Libere só pelo webhook
Ocompleted 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.amountvem em reais e inclui os juros quando o cliente paga o parcelamento. Por isso o exemplo comparaproductAmount, 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
pendingna 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
completede o webhook, o pedido ainda está “aguardando”. O exemplo guarda otransactionIdna 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
retryablede cadafailed. Umunknowncomretryable: falsepede para conferir antes de cobrar de novo. Veja eventos e erros.
O que configurar
- Sinnu Elements liberado para a empresa. Fale com o suporte de integração.
- A origem exata do site em Domínios permitidos, em Configurações → Checkout embutido.
https://www.loja.exemplo.com.bré outra origem quehttps://loja.exemplo.com.br. Veja domínios permitidos. - Um webhook assinando
transaction.*, apontando para a rota do app. Veja webhooks. - A Content Security Policy do site com o checkout em
frame-src. O exemplo usa a variante simples, com'unsafe-inline'emscript-src. Em produção, prefira a variante com nonce. referencee endereços sem dado pessoal. Use oiddo 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.