> ## 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.

# Valores: visão geral

> Como o dinheiro flui na Z2Pay: centavos, moeda BRL, taxas, split e liquidação na carteira até o saque.

Esta seção explica o **caminho do dinheiro** dentro da Z2Pay: do momento em que uma cobrança é
paga até o valor ficar disponível para saque. Antes de integrar split ou consultar saldos, vale
entender como cada valor é representado e por onde ele passa.

<Note>
  Esta página é conceitual. Os endpoints concretos estão nas páginas
  [Taxas](/pt-BR/valores/taxas), [Split](/pt-BR/valores/split) e
  [Liquidação](/pt-BR/valores/liquidacao).
</Note>

***

## Duas regras que valem para tudo

<CardGroup cols={2}>
  <Card title="Valores em centavos" icon="coins">
    Todo valor monetário é um **inteiro em centavos**. `R$ 10,00` é enviado e retornado como
    `1000`. Para exibir, divida por 100. Nunca envie casas decimais (`10.00`) em campos de valor.
  </Card>

  <Card title="Moeda BRL" icon="banknote">
    A moeda padrão é **BRL** (Real). Quando um campo `currency` aparece, ele segue o padrão
    ISO 4217 com 3 letras (ex.: `"BRL"`).
  </Card>
</CardGroup>

<Warning>
  Se você enviar `1050` pensando em "R\$ 1.050,00", a Z2Pay vai entender **R\$ 10,50**. Centavos
  sempre. Confira a página de [convenções](/pt-BR/convencoes) para os detalhes de formatação.
</Warning>

***

## O caminho do dinheiro

O fluxo padrão de uma venda até o saque tem cinco etapas:

```mermaid theme={null}
flowchart LR
  A[Cobrança paga] --> B[Split sobre o bruto]
  B --> C[Taxa debitada do responsável]
  C --> D[Crédito na carteira]
  D --> E[Saque]
```

<Steps>
  <Step title="Cobrança paga">
    O cliente paga uma transação (cartão, Pix ou boleto). O valor bruto entra no sistema em
    centavos. Veja [Transações](/pt-BR/transactions) e
    [Pagamentos](/pt-BR/payments).
  </Step>

  <Step title="Split entre recebedores">
    Se o pagamento tiver um split configurado, o **valor bruto** é repartido entre os recebedores
    conforme a regra (por percentual ou valor fixo). Quando a divisão não fecha em centavos
    inteiros, a sobra vai para a fatia de quem arca com a taxa. Veja
    [Split](/pt-BR/valores/split).
  </Step>

  <Step title="Taxa de processamento debitada do responsável">
    A taxa de processamento **não é rateada** entre os recebedores: ela é debitada
    **integralmente** da fatia do recebedor marcado com `processingFee: true` — ou da fatia
    `platform_fee`, quando ela existe. Os demais recebedores ficam com a fatia bruta cheia.
    Veja [Taxas](/pt-BR/valores/taxas).
  </Step>

  <Step title="Crédito na carteira">
    Cada fatia do split vira um crédito na **carteira** do recebedor, já líquido do que lhe coube
    em taxas. O crédito entra *a liberar* e só depois vira saldo disponível — o prazo varia por
    método de pagamento. Veja [Liquidação](/pt-BR/valores/liquidacao).
  </Step>

  <Step title="Saque">
    Com saldo liberado na carteira, o recebedor solicita um **saque** para sua conta
    bancária. Veja [Liquidação](/pt-BR/valores/liquidacao).
  </Step>
</Steps>

***

## Exemplo do fluxo em números

Uma venda de **R\$ 100,00** (`10000` centavos) com uma taxa de processamento de **R\$ 5,00**
(`500`) e um split de 70% / 30% entre dois recebedores fica assim:

|                                    | Fatia do bruto | Taxa | Vai para a carteira |
| ---------------------------------- | -------------- | ---- | ------------------- |
| Recebedor A (70%, arca com a taxa) | 7000           | −500 | **6500**            |
| Recebedor B (30%)                  | 3000           | —    | **3000**            |

O split incide sobre os `10000` cheios. A taxa de `500` sai **inteira** da fatia de quem tem
`processingFee: true` — o recebedor B fica com a fatia bruta, sem desconto nenhum.

***

## Veja também

<CardGroup cols={2}>
  <Card title="Taxas" icon="percent" href="/pt-BR/valores/taxas">
    Como as taxas incidem sobre o valor bruto.
  </Card>

  <Card title="Split" icon="git-fork" href="/pt-BR/valores/split">
    Configurar o rateio entre recebedores.
  </Card>

  <Card title="Liquidação" icon="wallet" href="/pt-BR/valores/liquidacao">
    Carteira, liberação de saldo e saque.
  </Card>

  <Card title="Recebedores" icon="users" href="/pt-BR/recipients">
    Cadastrar quem recebe no split.
  </Card>
</CardGroup>