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

# Splits

> Como a divisão do valor de uma venda entre recebedores é descrita, validada e aplicada a um pagamento.

Um **split** é uma regra reutilizável que descreve como dividir o valor de uma transação entre seus recebedores. Você cria a configuração uma vez e a referencia depois ao criar transações.

O vínculo com o dinheiro é por **pagamento**, não por transação: ao criar a transação, cada item de
`payments[]` aceita `splitId` (referência a uma configuração salva, prefixo `spl_`) **ou** `split`
(a mesma regra inline). Os dois no mesmo pagamento são recusados — é um ou outro.

<Info>
  Todas as requisições usam o header `x-api-key`. Veja [Autenticação](/pt-BR/autenticacao).
  A base URL de sandbox é `https://api.sandbox.z2pay.com/v1`.
</Info>

<Note>
  O modelo conceitual da divisão, com exemplos numéricos passo a passo, está em
  [Split](/pt-BR/valores/split).
</Note>

***

## Endpoints

| Método   | Rota           | Descrição                     |
| -------- | -------------- | ----------------------------- |
| `GET`    | `/splits`      | Lista paginada de splits      |
| `GET`    | `/splits/{id}` | Busca um split por ID         |
| `POST`   | `/splits`      | Cria um split                 |
| `PATCH`  | `/splits/{id}` | Atualiza um split             |
| `DELETE` | `/splits/{id}` | Remove um split (soft delete) |

***

## Regras do array `config`

Um split tem um `name`, opcionalmente vínculos com vendas/checkout, e um array `config`
com as regras de divisão. O que cada campo do item significa está no playground de
[Criar split](/pt-BR/splits/create); o que a validação exige do array inteiro está aqui.

<Warning>
  Violar qualquer uma destas retorna `400`:

  * Pelo menos **1** item de split é obrigatório.
  * **Exatamente 1** item com `processingFee: true` — é quem arca com a taxa de processamento.
  * **Exatamente 1** item com `liable: true` — é quem responde por chargebacks.
  * Se **houver pelo menos um** item com `valueType: "percentage"`, a **soma dos `value` desses itens percentuais deve ser exatamente 100** (tolerância de 0.01). Itens `fixed` não entram nessa soma.
</Warning>

***

## Veja também

<CardGroup cols={2}>
  <Card title="Split (valores)" icon="calculator" href="/pt-BR/valores/split">
    Modelo conceitual e exemplos numéricos passo a passo da divisão.
  </Card>

  <Card title="Recebedores" icon="users" href="/pt-BR/recipients">
    Cadastre os recebedores referenciados em `recipientId`.
  </Card>

  <Card title="Transações" icon="arrow-right-left" href="/pt-BR/transactions">
    Aplique um split ao criar uma transação.
  </Card>

  <Card title="Erros" icon="circle-alert" href="/pt-BR/erros">
    Formato dos erros e como tratar `400` / `404`.
  </Card>
</CardGroup>