Como funciona o saldo
O saldo tem três partes:
A API traz ainda
processingAnticipation: o valor de recebíveis de cartão com antecipação pedida que ainda não entrou no disponível. No dashboard, ele aparece como Antecipação em processamento, em Financeiro → Antecipações.
Todos os valores da API são em centavos (1000 = R$ 10,00).
Quando o dinheiro fica disponível
A taxa de cada venda já sai descontada quando o valor entra no saldo. Veja Taxas.
Saldo de Pix e boleto e saldo de cartão
Se a sua conta recebe cartão, o disponível fica separado em dois: o saldo de Pix e boleto e o saldo de cartão. Em Financeiro → Saques e em Financeiro → Pagamentos, cada um aparece com o próprio botão.- Cada saque ou envio de Pix sai de um saldo só. Não dá para juntar os dois na mesma operação.
- O TED sai só do saldo de Pix e boleto.
- Na API, o
balancede Obter detalhes da loja mostra a soma dos dois.
Extrato da conta
O extrato lista o que já mexeu no seu saldo, da movimentação mais recente para a mais antiga. Ficam de fora:- transações ainda pendentes: um Pix aguardando pagamento só aparece depois de pago;
- movimentações internas que não mudam o disponível, como a solicitação de antecipação. A antecipação creditada aparece normalmente;
- os saques das subcontas, que saem do saldo do vendedor. Quando um Pix com split é pago, a parte de cada subconta aparece no seu extrato como saída Split para subconta.
Pelo dashboard
Em Financeiro → Extrato você encontra:- no topo, o saldo Disponível para saque, Em processamento e Bloqueado;
- o período (Hoje, Esse mês, Últimos 30 dias ou Últimos 90 dias), com o gráfico Evolução do saldo e o Resumo do período: entradas, saídas, taxas pagas e variação do saldo;
- o Histórico, com filtros por meio de pagamento (Pix, cartão, boleto), status (Concluído, Em processamento, Em disputa) e tipo (Vendas, Saques, Reembolsos, Disputas);
- o botão Exportar, que baixa o extrato do período em CSV, Excel, PDF ou OFX.
Pela API
Use Listar extrato, com a permissãoBANK_STATEMENT:READ. Cada item é uma transação e traz uma ou mais movimentações em movements. Um pagamento recebido, por exemplo, gera duas: a entrada do valor e a saída da taxa.
amount de cada movimentação é sempre positivo. O sentido vem de balanceEffect:
Para saber o efeito de uma transação no disponível, some os
amount com credit e subtraia os que têm debit.
O category diz o tipo da movimentação:
Outros campos úteis:
referenceId: oexternalIdque você mandou no saque ou no Enviar Pix.checkoutIdepaymentIntentId: o checkout e a cobrança de origem. Vêmnullnos saques.customer: o cliente da cobrança. Num Pix sem cliente cadastrado, como o Pix na chave fixa, traz só o nome e o CPF/CNPJ de quem pagou. Énullquando não há nenhum dado.
status, method e kind aceitam um valor por vez e valem para a transação. Sem status, a API esconde as transações PENDING; sem kind, esconde as movimentações internas. Ao informar o filtro, a regra padrão dele deixa de valer: status=PENDING traz as pendentes.
Para ler o saldo atual, use Obter detalhes da loja, com a permissão STORE:READ:
Perguntas frequentes
Por que a venda no cartão não está no saldo disponível?
Por que a venda no cartão não está no saldo disponível?
O cartão fica pendente até a liquidação, no prazo de recebimento da sua conta. O prazo aparece em Perfil → Taxas. Quando liquida, o valor passa para o disponível.
O que é o saldo bloqueado?
O que é o saldo bloqueado?
É o valor retido por uma disputa ou MED em aberto, por análise de segurança ou pela reserva preventiva de cartão. Ele não pode ser sacado até ser liberado. Para saber o motivo de um bloqueio, fale com o suporte em ajuda@abacatepay.com.
Por que não consigo sacar a soma do saldo de Pix com o de cartão?
Por que não consigo sacar a soma do saldo de Pix com o de cartão?
Os dois saldos são separados, e cada saque sai de um só. Faça um saque de cada saldo.
Um Pix aguardando pagamento aparece no extrato?
Um Pix aguardando pagamento aparece no extrato?
Não. O extrato mostra só o que já mexeu no saldo. O Pix aparece depois de pago.
Os saques das subcontas aparecem no meu extrato?
Os saques das subcontas aparecem no meu extrato?
Não, porque saem do saldo da subconta. No seu extrato aparece a parte que foi para a subconta quando o Pix com split é pago, como Split para subconta.