1. Prepare o ambiente
Obtenha o SDK conforme a distribuição disponível. ConfigureSINNU_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émimport "server-only" para impedir uma importação acidental em um Client Component.
checkout.ts
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 oslug 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.