Esta página é conceitual. Os endpoints concretos estão nas páginas
Taxas, Split e
Liquidação.
Duas regras que valem para tudo
Valores em centavos
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.Moeda BRL
A moeda padrão é BRL (Real). Quando um campo
currency aparece, ele segue o padrão
ISO 4217 com 3 letras (ex.: "BRL").O caminho do dinheiro
O fluxo padrão de uma venda até o saque tem cinco etapas:1
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 e
Pagamentos.
2
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.
3
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.4
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.
5
Saque
Com saldo liberado na carteira, o recebedor solicita um saque para sua conta
bancária. Veja Liquidação.
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:
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
Taxas
Como as taxas incidem sobre o valor bruto.
Split
Configurar o rateio entre recebedores.
Liquidação
Carteira, liberação de saldo e saque.
Recebedores
Cadastrar quem recebe no split.