Documentação · v2

Bem-vindo à API da Pagnovo

Tudo o que você precisa pra integrar pagamentos PIX, transferências e gestão financeira na sua aplicação — com SDKs, CLI e suporte a agentes de IA.

O que é a Pagnovo?

A Pagnovo é uma plataforma de pagamentos PIX construída para desenvolvedores. Nascemos da própria necessidade de simplificar cobranças — percebemos que os meios de pagamento existentes eram excessivamente complexos: documentações confusas, processos longos de homologação e múltiplas formas de fazer a mesma coisa.

Nossa solução é uma API que transforma essa complexidade em algo simples e intuitivo:

TypeScript

import { pagnovo } from '@pagnovo/sdk';

await pagnovo.transactions.create({
  amount: 1000,          // R$ 10,00 em centavos
  paymentMethod: 'PIX',
  cpf: '12345678901',
  email: 'cliente@exemplo.com',
  description: 'Pedido #5678',
});

Princípios da API

Baseada em intenção

Cada endpoint representa exatamente o que você lê. POST /transactions/v2/purchase cria uma transação. Sem ambiguidade.

Consistente

Toda resposta inclui x-trace-id pra debug. Erros vêm padronizados em {statusCode, message}. Idempotência onde faz sentido.

Comece por aqui

Autenticação

Configure sua secret key, IP allowlist e permissões.

Criar Cobrança PIX

Gere QR codes copia-e-cola pra receber em segundos.

Saque PIX

Envie valores via chave PIX ou QR Code programaticamente.

Webhooks v2

Receba eventos em tempo real com assinatura HMAC-SHA256.

Verificar assinatura

Como validar webhooks antes de processar.

Trace ID

Correlacione requests entre seu sistema e o nosso.

Para agentes de IA

A documentação completa está disponível em formato otimizado para LLMs. Aponte seu agente para o arquivo abaixo:

https://portal.pagnovo.com/llms.txt

Inclui descrição da API, exemplos de uso, schemas e fluxos típicos em formato markdown plano.

Ambiente de produção

Todas as requisições em produção usam o seguinte endereço base:

https://api.pagnovo.com

O ambiente (sandbox ou produção) é determinado pela chave de API usada — não pela URL.