Bem-vindo à API da Nucleo Pay

Tudo o que você precisa para integrar pagamentos PIX: cobranças instantâneas, webhooks confiáveis e ferramentas para desenvolvedores e assistentes de IA.

Ver referência da API Chaves de API Experimentar demonstração llms.txt

O que é a Nucleo Pay?

A Nucleo Pay é um gateway de pagamento PIX pensado para quem quer cobrar sem complexidade. Uma API direta, documentação clara e integração com IAs via MCP — transforme cobranças em poucas linhas de código. 

await fetch("https://nucleopay.com.br/api/pix/charge/create", {
  method: "POST",
  headers: {
    Authorization: "Bearer SEU_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ value: 49.9, title: "Meu produto" })
});

Princípios da API

Baseada em intenção

Cada endpoint faz o que o nome diz. POST /api/pix/charge/create cria uma cobrança. Sem ambiguidade.

Consistente

Toda resposta segue { success, data, error }. Se success for true, os dados estão em data.

O que você pode fazer

Receber via PIX

Gere cobranças com valor e título — ideal para bots, lojas e SaaS.

Webhooks

Receba notificações em tempo real com assinatura HMAC SHA256.

Consultar status

Verifique se a cobrança foi paga via polling ou eventos.

Listar cobranças

Recupere cobranças recentes da sua conta em um único endpoint.

Tokens de API

Autentique integrações com Bearer tokens gerados no painel.

Integração via MCP / LLM

Conecte Cursor, Claude, Trae ou Lovable com ferramentas tipadas.

Exemplos de código

cURL, JavaScript, Python, PHP e Go prontos para copiar.

Checkout PIX

Página de pagamento hospedada para vender sem montar UI do zero.

Primeiros passos

Chaves de API

Gere e gerencie tokens Bearer para autenticar suas requisições.

Ambiente de testes

Explore tokens e webhooks simulados sem criar conta.

Configurar webhooks

Cadastre URLs e valide eventos com o header de assinatura.

Produção

Crie sua conta gratuita e comece a receber PIX de verdade.

Saiba mais sobre a Nucleo Pay

Referência completa

Endpoints, autenticação e exemplos interativos na mesma página.

Integração com IA

MCP para Cursor, Claude, Trae e Lovable — configure em minutos.

Site e suporte

Conheça a plataforma, planos e entre em contato com a equipe.

Modo demonstração — explore tokens e webhooks simulados abaixo. Para integração real, crie sua conta gratuita.

Painel interativo (simulado)

Teste como seria gerenciar tokens e webhooks — os dados não são salvos no servidor.

Tokens de API

Simule a criação de tokens para sua integração.

Nenhum token criado. Clique em Novo token para simular.

Webhooks

Cadastre URLs para receber eventos de pagamento.

Nenhum webhook cadastrado.

Assinatura

Validamos cada POST com o header X-NucleoPay-Signature (HMAC SHA256 do body).

Documentação

Endpoints, autenticação e exemplos de integração.

Base URL
https://nucleopay.com.br
Autenticação

Envie o header Authorization: Bearer SEU_TOKEN em todas as requisições.

Endpoints
POST

/api/pix/charge/create

Cria cobrança PIX

GET

/api/pix/charge/status

Consulta status da cobrança

GET

/api/pix/charges

Lista cobranças recentes

Exemplo — criar cobrança

Novo

Integração via MCP / LLM

Conecte Cursor, Claude, Lovable, Trae ou qualquer assistente compatível com MCP.

Manifesto JSON

O Model Context Protocol (MCP) expõe ferramentas tipadas para o LLM: criar cobrança PIX, consultar status, cadastrar webhooks e validar assinaturas — sem copiar documentação manualmente.

  1. 1. Instale: pip install -r requirements-mcp.txt
  2. 2. Configure seu token em NUCLEOPAY_API_TOKEN
  3. 3. Adicione o servidor MCP na sua ferramenta (veja exemplos ao lado)
Claude Trae Lovable Cursor

Cursor Settings → MCP → adicione o servidor abaixo.

Ferramentas: create_pix_charge, get_pix_charge_status, create_webhook, verify_webhook_signature, generate_integration_snippet e mais.

Pronto para integrar de verdade?

Crie sua conta gratuita e acesse o painel completo com tokens reais, webhooks funcionais e suporte à integração.

Criar conta grátis Já tenho conta