# PYPAG

> Plataforma brasileira de pagamentos para criadores, desenvolvedores e pequenos negócios: Pix, perfil público, doações, links de cobrança, saque e Merchant API (cash-in, cash-out, split). Site oficial: https://pypag.com.br

PYPAG não é um gateway genérico: combina **conta + painel + página pública personalizável** com **API merchant** para integrações server-to-server.

## Documentação para modelos de linguagem

- **MCP (Cursor / Claude Desktop):** `mcp/server.mjs` — a IA deve chamar **`pypag_load_context`** (carrega `pypag-especialista.txt`, bateria, llms) ou ler resources `pypag://docs/*`. Chave `mcp_live_` no dashboard → **Credenciais** (conta logada); documentação em `/developers?tab=mcp`.
- [Contexto completo para colar no chat](/docs/pypag-especialista.txt): system prompt / briefing — use isto para virar especialista PYPAG
- [Base estendida (llms-full)](/llms-full.txt): produto, taxas, KYC, API, limites e FAQ técnico
- [Merchant API (tester)](/developers): documentação interativa com exemplos JSON
- [SDKs oficiais](/sdk): Node/Python/PHP/Go — install pela URL (`npm install https://pypag.com.br/sdk/pypag.tgz`, etc.); docs em `/developers?tab=sdk`
- [Documentação interna do repositório](/docs/pypag-documentacao.md): arquitetura, segurança e mapa de rotas

## Produto (resumo factual)

- **Pix recebido:** taxa fixa **R$ 0,45** por transação aprovada (configurável via env no servidor).
- **Saque para o CPF titular:** taxa **R$ 1,50**, mínimo **R$ 10**; sem mensalidade.
- **KYC:** não é exigido para **receber** Pix nem para **sacar para o próprio CPF** cadastrado; **KYC aprovado** é exigido para **Pix-out / cash-out merchant** para terceiros e operações sensíveis.
- **Merchant API v1:** `POST /api/v1/cash-in`, `cash-out`, `split`; `GET balance`, `transactions`; autenticação `X-Api-Key` (`pk_live_…`); **Idempotency-Key** obrigatória em cash-in e split.
- **SDKs:** https://pypag.com.br/sdk — Node `npm install https://pypag.com.br/sdk/pypag.tgz`; Python `pip install https://pypag.com.br/sdk/pypag-python.tar.gz`; PHP via `php-repo.json`; Go tarball.
- **Perfil público:** `https://pypag.com.br/{username}`; doação em `/{username}/donate`.
- **Cripto:** comunicação pública da marca (landing/sobre); integração Pix + EvoPay é o núcleo implementado no produto open-source deste repositório.

## Links institucionais

- [Termos e privacidade](/termos)
- [Sobre](/sobre)
- [Contato](/contato)
- [Blog](/blog)

## Optional

- [Rubrica de qualidade para IAs avaliarem respostas sobre PYPAG](/docs/ia-rubrica.txt): critérios objetivos (nota 0–10)