Integrar pagamento no site é fazer o seu site cobrar e saber, sozinho, quando o cliente pagou. Com a NewPag, há dois caminhos. O simples é colocar um link de pagamento num botão do site, sem escrever código. O completo é ligar o seu sistema à API da NewPag: o site cria a cobrança Pix, mostra o QR Code na sua própria página e recebe um aviso automático quando o pagamento é confirmado. A documentação é aberta em app.newpag.app/docs.
Três níveis de integração
| Nível | O que você faz | Esforço | Resultado |
|---|---|---|---|
| Link no botão | Cria um link no painel e cola num botão do site | Nenhum código | O cliente sai do seu site e paga na página da NewPag |
| API | O seu sistema pede a cobrança e mostra o Pix | Precisa de programador | O cliente paga sem sair da sua página |
| API com webhooks | O seu sistema também recebe os avisos | Precisa de programador | O pedido é atualizado sozinho quando o Pix é pago |
Comece pelo nível que resolve o seu problema hoje. Dá para trocar depois.
Sem programar: um link de pagamento no botão do site
Crie um link de pagamento ou um produto no painel, copie o endereço e use como destino de um botão "Comprar" ou "Pagar". Ao clicar, o cliente abre o checkout da NewPag, com o nome da sua empresa e o valor, gera o Pix e paga. Funciona em qualquer construtor de sites que aceite um botão com link.
A limitação: o seu site não fica sabendo do pagamento sozinho. Você confere em Transações no painel ou pelo e-mail de venda aprovada, se ativar.
Com a API: o Pix dentro da sua página
API é a porta pela qual um sistema conversa com outro. Na prática, funciona assim:
- O cliente fecha o pedido no seu site.
- O seu sistema pede à NewPag uma cobrança Pix com o valor, os dados do cliente e, se quiser, o número do pedido.
- A NewPag devolve o código copia e cola e a imagem do QR Code, prontos para exibir.
- O seu site mostra os dois na página de pagamento.
- Quando o cliente paga, a NewPag confirma o pagamento e o seu sistema fica sabendo.
O número do pedido que você manda volta junto em todas as respostas e avisos, o que facilita achar a venda certa. A API também permite consultar cobranças, ver o saldo, fazer o estorno total de uma cobrança paga e pedir saque por Pix, quando o saque pela API está liberado para a sua conta.
Webhooks: o aviso de que o cliente pagou
Webhook é um aviso que a NewPag envia para um endereço do seu sistema sempre que algo acontece. Em vez de o seu site perguntar a cada minuto "já pagou?", a NewPag avisa. Você escolhe quais avisos quer receber:
- cobrança criada, aguardando pagamento;
- pagamento confirmado;
- estorno concluído ou recusado;
- saque processando, concluído ou com falha;
- abertura e resultado de disputas, quando o recurso está ativo na sua conta.
Cada aviso vai assinado com um segredo que só você e a NewPag conhecem, para o seu sistema conferir que ele veio mesmo da NewPag. Se o seu sistema não responder, a NewPag tenta de novo até 3 vezes. No painel, em Webhooks, você vê o histórico de entregas e pode reenviar um aviso.
O que o painel oferece para quem integra
Tudo fica na área Desenvolvedores do painel:
- Chaves de API. Cada credencial tem uma chave pública e um segredo. O segredo aparece uma única vez, na criação. Você pode revogar uma chave na hora e restringir o uso a endereços de IP que você escolher.
- Chaves de teste. Integram pelo mesmo caminho, sem mover dinheiro de verdade, e permitem simular o pagamento. Podem ser criadas enquanto o cadastro ainda está em análise.
- Logs da API. Cada requisição fica registrada por 30 dias, com resultado, tempo de resposta e um código de identificação para o suporte.
- Docs para IA. Um arquivo em texto, o llms.txt, que assistentes de IA conseguem ler. Você cola o endereço no assistente e pede a integração.
- Documentação. A referência completa, com exemplos, em app.newpag.app/docs.
Os cuidados com chaves, assinatura dos avisos e acesso à conta estão em segurança.
Como orientar quem vai fazer a integração
Se você vai contratar alguém, esta lista ajuda a conversa:
- Envie o link da documentação da API.
- Peça para começar com a chave de teste e simular um pagamento.
- Combine que o segredo da chave fica só no servidor, nunca na página que o cliente abre.
- Peça para cadastrar o webhook de pagamento confirmado e conferir a assinatura de cada aviso.
- Peça para enviar o número do pedido em cada cobrança.
- Só então troque para a chave de produção e faça uma venda real de valor baixo.
Integração para lojas virtuais
Em loja virtual, a combinação mais comum é API com webhooks: o pedido é criado, o Pix aparece na finalização da compra e o status muda para pago sem ninguém mexer. Veja mais em gateway de pagamento para e-commerce. Se você ainda não tem site, comece pelo Pix no painel e pelos links.
Perguntas frequentes
Preciso de programador para integrar pagamento no site?
Para usar a API, sim, ou alguém com experiência em sites. Sem programar, você pode colocar um link de pagamento da NewPag num botão do site e receber por Pix do mesmo jeito.
Dá para testar a integração sem dinheiro de verdade?
Sim. No painel você cria chaves de teste. Elas usam o mesmo caminho da integração real, mas as cobranças ficam separadas, não entram no saldo e o pagamento pode ser simulado. A chave de teste pode ser criada antes da aprovação do cadastro.
A API funciona com qualquer linguagem de programação?
Funciona com qualquer linguagem que consiga fazer requisições pela internet. A API usa o formato JSON e a documentação traz exemplos em cURL e Node.js.
Onde fica a documentação da API?
Em app.newpag.app/docs, aberta para qualquer pessoa. Há também uma versão em texto para assistentes de IA em app.newpag.app/llms.txt.
Como eu sei se a integração está funcionando?
O painel tem a tela Logs da API, com cada requisição, o resultado e o tempo de resposta, e o histórico de entregas de cada webhook, com a opção de reenviar um aviso.