Pular para o conteúdo principal
O fluxo tem três partes: um serviço de criação no servidor, uma interface que abre o checkout e um endpoint de webhook.

1. Prepare o ambiente

Obtenha o SDK conforme a distribuição disponível. Configure SINNU_API_KEY e SINNU_WEBHOOK_SECRET no servidor, sem o prefixo NEXT_PUBLIC_.

2. Crie um serviço de checkout

Coloque este código em um módulo usado apenas no servidor. No Next.js, use também import "server-only" para impedir uma importação acidental em um Client Component.
checkout.ts
Em uma Route Handler ou Server Action, autentique o usuário quando o seu fluxo exigir, carregue o pedido e obtenha o preço do catálogo no servidor. Não repasse um preço recebido do navegador diretamente a createCheckout. Guarde linkId junto do pedido antes de devolver a URL. Em caso de timeout, consulte os links existentes antes de repetir a criação.

3. Abra a URL no frontend

Use a receita de botão com o slug retornado ou redirecione para url. Seu frontend não precisa importar Sinnu.

4. Confirme pelo servidor

Adicione um handler de webhook com runtime Node.js. Atualize o pedido de forma idempotente após consultar o estado da transação.

Confira antes de liberar

  • O preço é determinado no servidor e enviado em centavos.
  • O navegador recebe uma URL pública, sem chaves.
  • Repetir um evento não libera o pedido novamente.
  • Falha de persistência no webhook retorna erro.
  • Uma URL de retorno não é tratada como confirmação financeira.