Usar com IA e ferramentas de código

A Quantum Pay disponibiliza sua documentação em formato otimizado para inteligências artificiais, seguindo o padrão llms.txt e com servidor MCP (Model Context Protocol) nativo. Isso permite que você conecte qualquer assistente de IA às nossas docs e receba ajuda precisa na integração.

Conectar via MCP

O MCP permite que ferramentas de IA acessem a documentação completa em tempo real, com recursos estruturados e prompts pré-definidos para as integrações mais comuns. Claude

claude mcp add quantumpay --scope user --transport http https://quantum-pay-mcp.quantumpay.workers.dev/mcp

VS Code — adicione ao settings.json:

{
  "mcp": {
    "servers": {
      "quantumpay": {
        "type": "http",
        "url": "https://quantum-pay-mcp.quantumpay.workers.dev/mcp"
      }
    }
  }
}

OpenAI Codex

codex mcp add --name quantumpay --url https://quantum-pay-mcp.quantumpay.workers.dev/mcp

Após conectar, sua IA terá acesso a:

Documentação completa de todos os endpoints
Guias separados por seção (autenticação, PIX IN, PIX OUT, webhooks)
Prompts pré-definidos para integrações comuns

Formatos disponíveis

Servidor MCP

Endpoint MCP nativo. Compatible com Claude, VS Code Copilot, Codex e qualquer cliente MCP.

llms.txt — resumido

Versão concisa da API com todos os endpoints essenciais. Ideal para contexto inicial e prompts rápidos.

OpenAPI (YAML)

Especificação OpenAPI 3.1 completa. Compatível com Postman, Insomnia e geração automática de clientes.

Referência da API

Códigos de erro, status e rate limits documentados em detalhe.

Como conectar sua IA favorita

Claude (chat)

Abra uma conversa no Claude e cole o prompt abaixo:

Leia a documentação da API da Quantum Pay em:
https://docs.quantumpay.com.br/llms.txt

Me ajude a integrar o PIX IN (recebimento via QR Code PIX)
em um projeto Node.js.

Ou acesse diretamente: claude.ai/new

ChatGPT

Abra o ChatGPT e cole:

Use a documentação da API Quantum Pay disponível em:
https://docs.quantumpay.com.br/llms.txt

Preciso integrar pagamentos PIX no meu sistema. Me guie passo a passo.

GitHub Copilot / VS Code

Crie o arquivo .github/copilot-instructions.md na raiz do seu projeto:

# Instruções para integração Quantum Pay

Este projeto usa a API Quantum Pay para processamento de pagamentos PIX.

Documentação da API: https://docs.quantumpay.com.br/llms.txt

## Pontos importantes:
- URL base: https://api.quantumpay.com.br
- Autenticação: Basic Auth (API Key + Secret) → Bearer Token JWT (30 min)
- Valores monetários: SEMPRE em centavos (R$ 10,00 = 1000)
- PIX IN: POST /api/v1/pix/in/qrcode
- PIX OUT: POST /api/v1/pix/out/pixkey com Idempotency-Key
- Webhooks: validar assinatura X-Signature com HMAC-SHA256

Cursor

Crie o arquivo .cursorrules na raiz do projeto:

# Quantum Pay API Integration

Documentação completa: https://docs.quantumpay.com.br/llms.txt

Regras:
- Todos os valores são em centavos
- Sempre renovar o Bearer Token antes de expirar (30 min)
- Usar Idempotency-Key em transferências PIX OUT
- Validar assinatura HMAC-SHA256 em todos os webhooks recebidos
- Retornar HTTP 200 imediatamente no endpoint de webhook

No chat do Cursor use:

@docs https://docs.quantumpay.com.br/llms.txt
Me ajude a integrar PIX IN e PIX OUT da Quantum Pay

Gemini

Leia a documentação da API Quantum Pay em:
https://docs.quantumpay.com.br/llms.txt

Preciso de ajuda para:
1. Autenticar com Basic Auth e obter Bearer Token
2. Criar uma cobrança PIX (QR Code)
3. Configurar webhook para confirmar pagamento

Prompts prontos para uso

Integração PIX IN básica

Usando a documentação em https://docs.quantumpay.com.br/llms.txt,
crie uma classe em Node.js que:
1. Autentica com a Quantum Pay usando API Key e API Secret
2. Cria uma cobrança PIX com QR Code
3. Exibe o QR Code e o código "copia e cola" para o cliente
4. Trata erros de autenticação e rate limit

Webhook completo com validação

Usando a documentação em https://docs.quantumpay.com.br/llms.txt,
crie um endpoint de webhook em Express que:
Valida a assinatura HMAC-SHA256 no header X-Signature
Processa o evento transaction_paid para liberar o produto
Processa o evento transfer_completed para confirmar saque
Retorna HTTP 200 imediatamente em todos os casos
Loga eventos inválidos sem quebrar

PIX OUT com idempotência

Usando a documentação em https://docs.quantumpay.com.br/llms.txt,
crie uma função para enviar transferência PIX OUT que:
1. Gera um Idempotency-Key único por transferência (UUID v4)
2. Envia para qualquer tipo de chave PIX (CPF, CNPJ, email, telefone, EVP)
3. Verifica o status da transferência via webhook
4. Trata o caso de transferência já enviada (idempotência)

SDK completo

Usando a especificação OpenAPI em https://docs.quantumpay.com.br/openapi.yaml,
gere um SDK em TypeScript para a Quantum Pay que:
1. Tipagem completa de todos os requests e responses
2. Gerenciamento automático de token (renovação antes de expirar)
3. Retry automático com exponential backoff para erros 429 e 5xx
4. Suporte a todos os endpoints: auth, pix-in, pix-out, webhooks

Dúvidas frequentes das IAs

Como a autenticação funciona?

A autenticação é em dois passos:

POST /api/auth com Authorization: Basic base64(apiKey:apiSecret) — retorna Bearer Token (JWT, 30 min)
Todas as outras requisições usam Authorization: Bearer <token>

O token expira em 30 minutos. Renove automaticamente antes de expirar.

Os valores são em reais ou centavos?

Sempre em centavos (inteiros). Nunca use ponto decimal.

R$ 1,00 = 100
R$ 10,50 = 1050
R$ 250,00 = 25000

O campo se chama amountInCents em todos os endpoints.

Como sei que o pagamento foi confirmado?

Via webhook do evento transaction_paid. Configure um endpoint público e registre via POST /api/v1/webhook. Nunca confie apenas no status retornado na criação — ele sempre começa como pending.

Como evitar PIX OUT duplicado?

Use o header Idempotency-Key com um UUID único por operação. Se você reenviar a mesma requisição com o mesmo Idempotency-Key, a API retorna o resultado da primeira chamada sem criar uma nova transferência.

Suporte

Suporte por e-mail

contato@quantumhubpay.com

Acessar dashboard

Gere suas credenciais e configure webhooks

Introdução

Autenticação

Empresa

PIX IN - Recebimento

PIX OUT - Envio

Webhooks

Referência

Usar com IA

Usar com IA e ferramentas de código

Conectar via MCP

Formatos disponíveis

Servidor MCP

llms.txt — resumido

OpenAPI (YAML)

Referência da API

Como conectar sua IA favorita

Claude (chat)

ChatGPT

GitHub Copilot / VS Code

Cursor

Gemini

Prompts prontos para uso

Dúvidas frequentes das IAs

Suporte

Suporte por e-mail

Acessar dashboard

​Conectar via MCP

​Formatos disponíveis

Servidor MCP

llms.txt — resumido

OpenAPI (YAML)

Referência da API

​Como conectar sua IA favorita

​Claude (chat)

​ChatGPT

​GitHub Copilot / VS Code

​Cursor

​Gemini

​Prompts prontos para uso

​Dúvidas frequentes das IAs

​Suporte

Suporte por e-mail

Acessar dashboard

Conectar via MCP

Formatos disponíveis

Como conectar sua IA favorita

Claude (chat)

ChatGPT

GitHub Copilot / VS Code

Cursor

Gemini

Prompts prontos para uso

Dúvidas frequentes das IAs

Suporte