# Split de pagamento

Split divide automaticamente o valor de uma cobrança entre contas recebedoras no momento da liquidação.

## Modelos

| Cenário | Onde a cobrança nasce | Como configurar |
|---|---|---|
| Master divide com parceiros | Conta master | Array `split` com `accountNumber` de cada recebedor |
| Seller divide com a master | Subconta (header `X-Sub-Account`) | Array `split` **sem** `accountNumber` |

## Split a partir da master

```json
{
  "amount": 1.00,
  "externalTxid": "loja-01-caixa-03",
  "split": [
    { "type": "fixed", "accountNumber": "896532569", "amount": 0.10 }
  ]
}
```

`POST /v1/charges/pix` com scope `pix.cob/write`. A resposta traz `chargeId` e `emv`.

## Split a partir do seller para a master

Mesmo body, **sem** `accountNumber` no item de split, e com o header:

```
X-Sub-Account: 896532569
```

A parcela definida no split vai para a conta master; o restante fica com o seller.

## Campos do split

| Campo | Obrigatório | Descrição |
|---|---|---|
| `type` | sim | `fixed` ou `percentage` — literal, em minúsculo |
| `amount` | sim | Valor em reais quando `fixed`; percentual de 0 a 100 quando `percentage` |
| `accountNumber` | condicional | Conta do recebedor; omitido quando o destino é a master |
| `publicId` | condicional | Alternativa ao `accountNumber`, em formato UUID |

Informe `accountNumber` **ou** `publicId`. Sem nenhum dos dois, a cobrança é recusada.

## Regras

- **Split só funciona em Pix e boleto.** Com `creditcard` ou `pix_automatico` a cobrança é recusada.
- Máximo de **20 recebedores** por cobrança.
- A soma dos splits percentuais não pode passar de 100%.
- A soma das parcelas não pode exceder o valor líquido da cobrança — senão, `400 SPLIT_EXCEEDS_NET_AMOUNT`.
- Recebedor duplicado no mesmo split é recusado.
- Valores em reais, com duas casas — `0.10`, não `10`.
- A subconta precisa estar aprovada no onboarding antes de receber split. Veja [Subcontas](../subcontas-overview.md).
- Use `externalTxid` para identificar a loja, o caixa ou o vendedor responsável pela cobrança.