Merchant API

Cole sua API key, escolha o endpoint e dispare contra a API (proxy /api no mesmo host).

Contexto para IAs

Briefing de Merchant API e integração — para colar no Cursor, ChatGPT ou Claude. Não é FAQ do produto (taxas, KYC, página pública).

X-Api-Key /api/v1 Idempotency-Key

O que mandar para o modelo

cash-in · cash-out · split · balance · transactions · media

Use isto quando a IA for escrever código, payloads ou setup de MCP. Chaves pk_live_ e mcp_live_ ficam no dashboard → Credenciais.

Tester nesta página (Merchant API). MCP: aba Servidor MCP + JSON no painel.

pypag-api-ia.txt Tester da API

Texto para colar

Instrução de API. Cole como system prompt ou primeira mensagem.

Carregando…

Arquivo: /docs/pypag-api-ia.txt

SDKs oficiais

Clientes da Merchant API. Instale pela URL do site — sem npm/PyPI público. Página: /sdk.

pk_live_ X-Api-Key idempotencyKey amount em R$

Instalar pela URL

https://pypag.com.br/sdk

Pacotes hospedados em pypag.com.br/sdk/*. Auth: X-Api-Key ou Bearer pk_live_…. Atalho client.pix.create → POST /api/v1/cash-in.

Node.js

npm install https://pypag.com.br/sdk/pypag.tgz
import Pypag from "pypag";

const client = new Pypag("pk_live_...");
const cobranca = await client.pix.create({
  amount: 49.90,
  idempotencyKey: "vip-1",
  description: "Cargo VIP no servidor",
});
console.log(cobranca.pixCode);

Python

pip install https://pypag.com.br/sdk/pypag-python.tar.gz
import pypag

client = pypag.Client("pk_live_...")
cobranca = client.pix.create(
    amount=49.90,
    idempotency_key="vip-1",
    description="Cargo VIP no servidor",
)
print(cobranca.pix_code)

PHP

composer config repositories.pypag composer https://pypag.com.br/sdk/php-repo.json
composer require pypag/sdk:1.0.0
$client = new \Pypag\Client('pk_live_...');
$cobranca = $client->pix()->create([
  'amount' => 49.90,
  'idempotencyKey' => 'vip-1',
  'description' => 'Cargo VIP no servidor',
]);
echo $cobranca['pixCode'];

Go

curl -L https://pypag.com.br/sdk/pypag-go.tar.gz | tar -xz
cd sdk-go

Métodos: cashIn / cash_in, split, cashOut / cash_out, balance, transactions, transaction(id), uploadMedia. Downloads: pypag.tgz · python · php · go.

Abrir /sdk Tester da API

Servidor MCP

Consulta read-only da conta (saldo, transações) para clientes MCP. Chaves mcp_live_… no dashboard → Credenciais.

mcp_live_ read-only X-Pypag-Mcp-Key

Chaves e consulta

GET /api/mcp/v1/wallet · GET /api/mcp/v1/transactions

Login obrigatório para gerar chave. No painel: /dashboard → Credenciais → Servidor MCP (JSON + env). Clientes: Cursor, Claude Desktop, etc. Não confundir com pk_live_ (Merchant API).

Header: X-Pypag-Mcp-Key: mcp_live_…. Tools: pypag_conta_wallet, pypag_conta_transactions.

mcp.md Gerar chave no dashboard

Template Cursor

MCP remoto Streamable HTTP — cole em .cursor/mcp.json (Cursor) ou equivalente. Header Authorization: Bearer mcp_live_…; reinicie o cliente.

{}

URL: https://mcp.pypag.com.br/mcp · chave no dashboard → Credenciais

Split

POST /api/v1/split

Base: mesma origem (/api via proxy)

Response

— 
Aguardando request…