Existem dois caminhos para colocar Pix em um site: usar um checkout pronto ou integrar a API na sua própria tela. A escolha depende de quanto controle você precisa e de quanto tempo tem.
Caminho rápido: checkout pronto
Você cria o produto, gera um link e começa a vender. Não há código envolvido, e a confirmação de pagamento continua acontecendo por webhook do lado do provedor. É a melhor opção para validar oferta, vender por redes sociais ou WhatsApp.
Caminho completo: API na sua tela
- Instale o SDK ou prepare o cliente HTTP da sua linguagem.
- Crie a cobrança no servidor — nunca no navegador.
- Renderize QR Code e Copia e Cola na sua página.
- Exponha o endpoint de webhook e valide a assinatura.
- Atualize a tela quando o pagamento for confirmado.
Requisitos técnicos
- Backend capaz de guardar segredo com segurança.
- Endpoint público HTTPS para webhook.
- Armazenamento do identificador da cobrança junto ao pedido.
- Logs sem dados sensíveis do pagador.
Antes de ir para produção
Rode o fluxo completo em teste, incluindo expiração e reenvio de webhook. Só então troque a credencial e acompanhe as primeiras transações de perto.