# WyzeCash

> Gateway de pagamentos brasileiro: cobranças por Pix, cartão de crédito e cripto, links de pagamento, saldo e extrato, saques, Pix enviado, subcontas, MED e webhooks. API REST em `https://app.wyzecash.com.br/v1`, valores sempre em centavos e a chave de API no cabeçalho `Authorization: Bearer bk_live_…`.

A documentação inteira num arquivo só, em texto simples (leia este): https://app.wyzecash.com.br/llms-full.txt

## Temas
- Como começar
- Chave de API e permissões
- Cobranças: Pix, cartão e cripto
- Links de pagamento
- WebSocket: eventos em tempo real sem endereço HTTPS
- Webhooks: eventos e assinatura
- Idempotency-Key
- Erros
- Limite de pedidos
- Saques
- Estornos
- Subcontas
- MED (pedido de devolução)
- Tarifas
- O MCP da WyzeCash

## Rotas da API
- `POST /v1/payments`: Criar cobrança (permissão `payments:create` ou `payments:create-card` ou `payments:create-crypto`)
- `GET /v1/payments/methods`: Formas de pagamento disponíveis (permissão `payments:create` ou `payments:create-card` ou `payments:create-crypto`)
- `GET /v1/payments`: Listar cobranças (permissão `payments:list`)
- `GET /v1/payments/:id`: Consultar cobrança (permissão `payments:get`)
- `POST /v1/payment-links`: Criar link de pagamento (permissão `payment-links:create`)
- `GET /v1/payment-links`: Listar links de pagamento (permissão `payment-links:list`)
- `GET /v1/payment-links/:id`: Consultar link de pagamento (permissão `payment-links:get`)
- `PATCH /v1/payment-links/:id`: Editar link de pagamento (permissão `payment-links:update`)
- `DELETE /v1/payment-links/:id`: Excluir link de pagamento (permissão `payment-links:delete`)
- `GET /v1/payment-links/:id/payments`: Cobranças geradas por um link (permissão `payment-links:payments`)
- `GET /v1/customers`: Listar clientes (permissão `customers:list`)
- `GET /v1/customers/:id`: Consultar cliente (permissão `customers:get`)
- `POST /v1/customers`: Criar cliente (permissão `customers:create`)
- `PATCH /v1/customers/:id`: Editar cliente (permissão `customers:update`)
- `DELETE /v1/customers/:id`: Excluir cliente (permissão `customers:delete`)
- `GET /v1/balance`: Saldo (permissão `account:balance`)
- `GET /v1/fees`: Tarifas da conta (permissão `account:fees`)
- `GET /v1/fees/preview`: Prévia da tarifa de um valor (permissão `account:fees`)
- `GET /v1/statement`: Extrato (permissão `account:statement`)
- `GET /v1/transactions`: Listar movimentações (permissão `account:transactions`)
- `GET /v1/transactions/:id`: Consultar movimentação (permissão `account:transactions`)
- `GET /v1/search`: Buscar na conta (permissão `account:search`)
- `GET /v1/receipts/:id`: Link do comprovante (permissão `receipts:get`)
- `GET /v1/meds`: Listar MED (permissão `meds:list`)
- `GET /v1/meds/:id`: Consultar MED (permissão `meds:get`)
- `POST /v1/meds/:id/respond`: Responder MED (permissão `meds:respond`)
- `POST /v1/withdrawals`: Sacar (permissão `withdrawals:create`)
- `GET /v1/withdrawals`: Listar saques (permissão `withdrawals:list`)
- `GET /v1/withdrawals/:id`: Consultar saque (permissão `withdrawals:get`)
- `POST /v1/refunds`: Estornar uma cobrança (permissão `refunds:create`)
- `GET /v1/refunds`: Listar estornos (permissão `refunds:list`)
- `GET /v1/refunds/:id`: Consultar estorno (permissão `refunds:get`)
- `POST /v1/subaccounts`: Criar subconta (permissão `subaccounts:create`)
- `GET /v1/subaccounts`: Listar subcontas (permissão `subaccounts:list`)
- `GET /v1/subaccounts/:id`: Consultar subconta (permissão `subaccounts:get`)
- `GET /v1/subaccounts/settings`: Configuração das subcontas (permissão `subaccounts:get`)
- `PUT /v1/subaccounts/settings`: Mudar a Configuração das subcontas (permissão `subaccounts:update`)
- `GET /v1/subaccounts/settings/preview`: Exemplo da taxa das subcontas (permissão `subaccounts:get`)
- `PATCH /v1/subaccounts/:id`: Editar subconta (permissão `subaccounts:update`)
- `DELETE /v1/subaccounts/:id`: Excluir subconta (permissão `subaccounts:delete`)
- `GET /v1/subaccounts/:id/entries`: Movimentos da subconta (permissão `subaccounts:entries`)
- `POST /v1/subaccounts/:id/fund`: Enviar saldo para a subconta (permissão `subaccounts:fund`)
- `POST /v1/subaccounts/:id/transfer`: Transferir entre subcontas (permissão `subaccounts:transfer`)
- `POST /v1/subaccounts/:id/return`: Devolver da subconta para a conta (permissão `subaccounts:return`)
- `POST /v1/subaccounts/:id/withdrawals`: Saque da subconta (permissão `subaccounts:withdraw`)

## Para assistentes com MCP
- Servidor MCP da WyzeCash: `https://app.wyzecash.com.br/mcp` (documentação sem chave; com a chave de API, as ferramentas da conta).

## Opcional
- Documentação para pessoas: https://bukio.mintlify.app