slug retornado:
Servidor
Redirecionamento
O caminho mais direto é abrir o checkout na mesma aba. Use uma âncora com texto que explique a ação:HTML
Parâmetros de campanha
O helper do SDK monta a URL e codifica parâmetros:TypeScript
utm_* são lidos pelo rastreamento da origem da venda: com um pixel ligado no link, a venda mostra de onde veio e a compra chega à plataforma de anúncios.
Pedido de cada venda
O link é o produto e pode ser vendido muitas vezes. Para saber qual pedido do seu sistema cada venda pagou, abra o checkout comreference:
TypeScript
reference em GET /api/transactions, no data.reference do webhook e no retorno para o redirectUrl. Ela tem até 255 caracteres. O código do produto vai no link, em externalReference, e volta como externalRef do item.
Dados do comprador preenchidos
Quando o link é criado ou atualizado comcustomer (em uma única requisição) ou linkedCustomer, o checkout abre com nome, e-mail, telefone (se enviado) e CPF/CNPJ mascarado (***.456.789-**) já preenchidos, sem trafegar dados pessoais na URL. Veja os campos aceitos em Links de pagamento.
O comprador pode concluir o pagamento imediatamente ou clicar em Alterar ao lado do documento mascarado para pagar com outro CPF/CNPJ. Se preferir manter o formulário do comprador na sua própria página e renderizar apenas Pix e cartão, use o elemento payment e envie customer no confirm().
Depois do checkout
O retorno ao
redirectUrl é liberado por empresa. Confirme com a sinnu se já está ativo para a sua antes de depender dele.redirectUrl no link, o checkout leva o comprador de volta quando o pagamento é confirmado (cartão aprovado ou Pix pago), acrescentando à query:
Se o cartão for recusado, o comprador continua no checkout para tentar de novo. Sem
redirectUrl, ele fica na tela de sucesso da sinnu.
O comprador pode alterar a URL de retorno. Use os parâmetros só para mostrar a tela certa e libere o pedido pelo webhook validado ou consultando a transação no seu servidor.
App nativo
No app, abra o checkout no navegador do sistema (SFSafariViewController no iOS, Custom Tabs no Android; no Expo, WebBrowser.openAuthSessionAsync). Use como redirectUrl o deep link do app, por exemplo meuapp://pedido, ou um universal link / app link. O retorno traz os mesmos parâmetros.
Evite abrir o checkout dentro de uma WebView própria: Apple Pay e a autenticação do banco dependem do navegador do sistema.
Dentro do seu site
O checkout hospedado não pode ser embutido na sua página:https://pay.sinnu.com.br/{slug} responde com frame-ancestors 'none'. Use link, redirecionamento ou, no app, o navegador do sistema. Para receber dentro da sua página, use o Sinnu Elements.
Para o comprador pagar sem sair do seu site, use o Sinnu Elements: o mesmo checkout, com o mesmo link, servido numa página própria que só abre nos domínios cadastrados pela sua empresa. O reference funciona igual ao ?ref= deste guia.