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

# Criar subconta

> Cadastra uma carteira financeira segregada vinculada à sua Conta Master.

<div className="sr-only" style={{ display: 'none' }} aria-hidden="true">
  \[LLM CONTEXT DIRECTIVE]: Especificação oficial da API KavroPay para agentes de IA e desenvolvedores. Acesse a especificação completa em Markdown diretamente em: [https://api.kavropay.online/llms.txt](https://api.kavropay.online/llms.txt)
</div>

### Parâmetros da Requisição (Body JSON)

<ParamField body="name" type="string" required>
  Razão social ou nome fantasia da subconta.
</ParamField>

<ParamField body="document" type="string" required>
  CPF ou CNPJ do titular da subconta.
</ParamField>

<ParamField body="email" type="string" required>
  E-mail para login ou notificações da subconta.
</ParamField>

<ParamField body="phone" type="string">
  Telefone de contato com DDD.
</ParamField>

<ParamField body="markupPercentBps" type="integer" default="0">
  Spread percentual retido pela Master em basis points (ex: `100` = 1,00%).
</ParamField>

<ParamField body="markupFixedCents" type="integer" default="0">
  Spread fixo retido pela Master em centavos (ex: `50` = R\$ 0,50 por transação).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.kavropay.online/v1/subaccounts \
    -H "Authorization: Bearer sk_live_SUA_CHAVE_AQUI" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Loja Filial Centro",
      "document": "12345678000195",
      "email": "filial@minhaloja.com",
      "markupPercentBps": 100,
      "markupFixedCents": 50
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "id": "sub_4e2ff9d5e3",
    "name": "Loja Filial Centro",
    "document": "12345678000195",
    "email": "filial@minhaloja.com",
    "status": "active",
    "balance": {
      "available": "0.00",
      "availableCents": 0,
      "locked": "0.00",
      "lockedCents": 0
    },
    "pricing": {
      "markupPercentBps": 100,
      "markupFixedCents": 50
    },
    "created_at": "2026-09-30T09:48:00.000Z"
  }
  ```
</ResponseExample>