Documentation Index — nucleopay.com.br/llms.txt

Produto e checkout via IA

Uma IA autenticada com o Bearer do vendedor cria o produto e a página de pagamento — só na conta dele.

O token define o dono. Não existe seller_id. A API não devolve venda, saldo, comprador nem o state cru do builder.

1. Criar produto + checkout

curl -X POST https://nucleopay.com.br/api/catalog/product \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mentoria de copy",
    "price": 197,
    "productType": "digital",
    "sacEmail": "suporte@minhaloja.com",
    "deliverableUrl": "https://meusite.com/acesso",
    "description": "Acesso imediato após o pagamento.",
    "headline": "Mentoria de copy",
    "buttonText": "Quero entrar",
    "photo": "https://cdn.meusite.com/capa.png",
    "payPix": true,
    "payCard": true
  }'

Resposta: product (campos públicos) e checkoutUrl em https://finalizarpedido.com.br/checkout/{id}.

Digital exige deliverableUrl HTTPS. Físico não. Valor mínimo R$ 1,60. Atualizar: envie id que já seja seu. Id de outra conta = 409.

2. Listar e ler (só a sua conta)

GET /api/catalog/products
GET /api/catalog/product?id=p123

404 se o id não for da conta do token. Sem sales, apiToken ou builder.

3. MCP

Tools: create_product_checkout, list_products, get_product. Bridge: POST /api/integrations/mcp/call.

curl -X POST https://nucleopay.com.br/api/integrations/mcp/call \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tool":"create_product_checkout","arguments":{"name":"Mentoria","price":197,"product_type":"digital","sac_email":"suporte@loja.com","deliverable_url":"https://meusite.com/acesso"}}'

O que a API recusa

Prompt pronto para IA

Crie um produto e o checkout na Nucleo Pay, só na conta deste token.
Docs: https://nucleopay.com.br/docs/catalog
POST /api/catalog/product
Auth: Authorization: Bearer SEU_TOKEN

Campos: name, price (>= 1.60), productType (digital|physical),
sacEmail, deliverableUrl (HTTPS, obrigatório se digital),
photo (HTTPS público ou data:image/png;base64),
description, headline, buttonText.

NÃO envie state/builder, seller_id, venda, saldo ou dado de cliente.
NÃO use localhost, HTTP ou IP privado.
A Nucleo não baixa a URL no servidor.
Resposta: data.checkoutUrl — é o link de venda.

IA / MCP

Cursor, Claude, Trae, Lovable.

Cobrar no cartão

Sessão com checkoutUrl.

CLI

nucleopay_cli catalog create