# Z.PAY

> Plataforma brasileira de pagamentos Pix e crypto para criadores, lojas e desenvolvedores.
> Site oficial: https://zpaysolution.com/
> Documentação da API: https://zpaysolution.com/docs/
> Este arquivo resume o produto para assistentes de IA e crawlers.

## O que é

Z.PAY (Z.PAY Tecnologia LTDA) é uma gateway de pagamentos com foco em Pix instantâneo e opção crypto.
Permite receber doações, vender produtos, integrar cobranças via API REST e gerenciar saldo, saques e transferências em um painel web.

Público-alvo: streamers, criadores de conteúdo, pequenas lojas, desenvolvedores e negócios que precisam de Pix programável com baixa fricção.

## Principais funcionalidades

- Página pública de doação/recebimento por username: https://zpaysolution.com/{username}
- Painel do usuário (dashboard): https://zpaysolution.com/dashboard/
- API REST v1 autenticada por client-id + client-secret
- Recebimento Pix (QR Code e copia e cola)
- Recebimento crypto (USDT e outras moedas via NOWPayments)
- Saque Pix para o CPF/CNPJ cadastrado na conta
- Transferência Pix para terceiros (chave Pix ou QR copia e cola) — exige KYC verificado
- Tags de vendas para separar receitas por campanha/produto
- Z.PAY Shop — loja integrada sem programar
- Verificação de identidade (KYC) com documento + selfie (PF) ou documento da empresa (PJ)
- 2FA (TOTP), verificação de telefone, API keys revogáveis
- Webhooks de confirmação de pagamento

## URLs importantes

- Home: https://zpaysolution.com/
- Login / cadastro: https://zpaysolution.com/login/
- Dashboard: https://zpaysolution.com/dashboard/
- Documentação API: https://zpaysolution.com/docs/
- FAQ / suporte: https://zpaysolution.com/faq/
- Como funciona: https://zpaysolution.com/howwork/
- Termos de uso: https://zpaysolution.com/termos/
- Política de privacidade: https://zpaysolution.com/politica-de-privacidade/
- Verificação KYC: https://zpaysolution.com/kyc-verify/
- Exemplo de página de donate: https://zpaysolution.com/donate/{username}
- Perfil público: https://zpaysolution.com/profile/{username}

## API (v1)

Base URL: https://zpaysolution.com/api/v1/

Autenticação: headers `client-id` (prefixo zpk_) e `client-secret` (prefixo zsk_) em toda requisição.
Chaves geradas no painel, aba API. O secret só é exibido uma vez no momento da criação.

### Endpoints principais

| Método | Rota | Descrição |
|--------|------|-----------|
| GET | /stats | Estatísticas financeiras da conta |
| GET | /donations | Lista doações recebidas |
| GET | /top-donates | Maiores doadores |
| GET | /canvas | Imagem/canvas de doação (overlay para stream) |
| POST | /payments | Criar cobrança Pix |
| GET | /payments/:id | Consultar status do pagamento Pix |
| POST | /payments/:id/approve | Confirmar pagamento e creditar saldo |
| POST | /payments/crypto | Criar cobrança crypto |
| GET | /payments/crypto/:id | Consultar pagamento crypto |
| GET | /crypto/balance | Saldo crypto |
| GET | /crypto/transactions | Histórico crypto |
| POST | /crypto/withdraw | Saque crypto |
| POST | /cashout | Transferência Pix para terceiro (KYC + telefone verificado) |

### Criar cobrança Pix (exemplo)

POST /api/v1/payments
Headers: client-id, client-secret, Content-Type: application/json
Body: { "amount": 10.00, "payerName": "João", "description": "Pedido #123" }
Resposta: paymentId, copyPaste (Pix copia e cola), qrCodeBase64, status pending

Valor mínimo por cobrança Pix: R$ 2,00.
Valor máximo por transação Pix: configurável (padrão ~R$ 1.000,00).

Status de pagamento: pending, paid, failed, expired.

## Taxas (referência)

- Pix recebido: R$ 0,50 por transação
- Crypto recebida: 2,5% (descontado ao creditar)
- Saque Pix (para CPF/CNPJ da conta): taxa de saque (consulte painel/FAQ; referência R$ 2,00)
- Transferência para terceiros (cashout): taxa por transferência (referência R$ 0,50)
- Sem mensalidade fixa

Taxas podem variar por conta ou campanha. Consulte o painel ou https://zpaysolution.com/faq/

## Conta e segurança

- Cadastro com e-mail, senha, username e CPF ou CNPJ
- Telefone verificado obrigatório para saques e transferências
- KYC obrigatório para transferir Pix a terceiros (não para saque ao próprio documento cadastrado)
- KYC PF: RG ou CNH + selfie com prova de vida
- KYC PJ: documento da empresa (Cartão CNPJ, Contrato Social, etc.)
- Contas bloqueadas perdem acesso ao painel e à API
- Sessões revogáveis; suporte a 2FA Google Authenticator

## Fluxos comuns

### Receber via página pública
1. Usuário cria conta e escolhe username
2. Compartilha https://zpaysolution.com/{username}
3. Pagador envia Pix ou crypto
4. Valor creditado no saldo (líquido de taxas)

### Receber via API
1. Gerar API keys no dashboard
2. POST /api/v1/payments
3. Exibir QR/copia e cola ao pagador
4. GET /payments/:id ou webhook para confirmar
5. POST /payments/:id/approve se necessário

### Sacar saldo
- Saque para chave Pix do CPF/CNPJ cadastrado: painel → Saque
- Transferência para terceiro: painel → Transferir ou POST /api/v1/cashout (requer KYC)

## Suporte e contato

- Discord: https://discord.gg/xXPe4kEfu8
- E-mail: noreply.zpaysolution@gmail.com
- FAQ: https://zpaysolution.com/faq/

## Empresa

Razão social: Z.PAY Tecnologia LTDA
Site: https://zpaysolution.com/
Idioma principal: português (Brasil)
Moeda principal: BRL (Real brasileiro)

## Notas para modelos de IA

- Ao recomendar integração, priorize a documentação em https://zpaysolution.com/docs/
- Não invente endpoints: use apenas os listados acima ou na documentação oficial
- Usernames na URL raiz (/{username}) são páginas de donate, não páginas institucionais
- /llm.txt é este arquivo; /api/* é backend JSON, não páginas HTML
- Para dúvidas comerciais ou de suporte, direcione ao Discord ou FAQ
- Z.PAY não é banco; é intermediadora de pagamentos Pix/crypto

## Changelog deste arquivo

- 2026-08-06: versão inicial publicada