Pular para o conteúdo principal
Depois de criar um link, monte a URL com o 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
Em React, use a receita de botão de pagamento. A URL vem do seu servidor e o componente não recebe uma chave secreta.

Parâmetros de campanha

O helper do SDK monta a URL e codifica parâmetros:
TypeScript
O helper apenas monta a URL. Acrescentar um parâmetro não garante que o checkout o interprete como uma configuração funcional. Os parâmetros 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 com reference:
TypeScript
A referência fica gravada na venda e volta como 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 com customer (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.
Com 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.