> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wyzecash.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Subcontas

> Separa o saldo de cada cliente seu em subcontas e divide as vendas.

> [!NOTE]
>
> Funciona sem chave: a IA lê a documentação e escreve o código no seu projeto.

## Endpoints usados

| Método | Rota | Permissão | Para quê |
| - | - | - | - |
| `POST` | `/v1/subaccounts` | `/subaccounts/create` | cria a subconta (`sacc_` ou o seu `externalId`) |
| `POST` | `/v1/payments` | `/payments/create` | cobra com `subaccountId` ou `split` |
| `GET` | `/v1/subaccounts/:id` | `/subaccounts/get` | o saldo da subconta |
| `GET` | `/v1/subaccounts/:id/entries` | `/subaccounts/entries` | os movimentos da subconta |
| Webhook | `subaccount.credited` · `subaccount.debited` | - | cada movimento numa subconta |

## Prompt

```text theme={null}
Quero separar o dinheiro de cada cliente meu com as subcontas da WyzeCash, em Node.js. Use as ferramentas do MCP da WyzeCash:
1. `ver_operacao` com `criar_subconta`: POST /v1/subaccounts, com o `externalId` igual ao id do cliente no meu sistema.
2. Nas vendas, POST /v1/payments com `subaccountId` (a venda toda para uma subconta) ou `split` (dividida entre até 10).
3. Saldo e movimentos de cada uma: GET /v1/subaccounts/:id e GET /v1/subaccounts/:id/entries.
4. Os webhooks `subaccount.credited` e `subaccount.debited` para atualizar o meu sistema.
Enviar, transferir, devolver e sacar da subconta mexem em dinheiro: escreva só o código (`exemplo_codigo`), com Idempotency-Key, para eu rodar no meu sistema.
```

Troque `Node.js` pela linguagem do seu projeto.

## Como chamar

| IA | Como |
| - | - |
| Claude Code | `/mcp__bukiopay__subcontas` |
| VS Code | `/mcp.bukiopay.subcontas` |
| Cursor, Codex e Claude Desktop | Copie o prompt acima e cole no chat |

## Parâmetros

| Parâmetro | O que é |
| - | - |
| `linguagem` | A linguagem ou o framework do projeto (ex.: Node.js, PHP, Python). |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.