Pular para o conteúdo
LeztyPay docs
Painel

Saques

Cobrança paga vira saldo. Saldo vira dinheiro na sua conta por meio de um saque para uma chave PIX.

#!/usr/bin/env bash
# Saldo do ambiente da chave. Todos os valores são inteiros em centavos.
set -euo pipefail

curl --fail-with-body -sS "$LM_API_URL/v1/balance" \
  -H "Authorization: Bearer $LM_API_KEY"

Todos os números do saldo são inteiros em centavos, e valem para o ambiente da chave que você usou.

O que cada número quer dizer

  • available é o que você pode sacar agora. É o único número que importa na hora de pedir um saque.
  • reserve vem sempre 0 no PIX: não há reserva. O campo fica no saldo só para não quebrar integrações.
  • pending_withdraw é o que já está preso num saque em andamento. Saiu de available e ainda não saiu da conta.
  • gross, fees, refunds, chargebacks e withdrawn são acumulados históricos, para conferência, não para decisão.

available pode ficar negativo. Um estorno ou uma contestação de uma venda cujo dinheiro já foi sacado tira do saldo o que não está mais lá. Enquanto estiver negativo, nenhum saque passa.

Quando o dinheiro fica disponível

No PIX não há reserva. Quando a cobrança é paga, o net inteiro entra em available, imediatamente, e o saque pode ser pedido na hora. Não existe janela de fechamento nem dia de repasse.

A reserva só existe em cobrança LATAM (voucher), onde o parceiro retém o valor até liquidar. Ela é liberada sozinha e você recebe transaction.reserve_released. Escute o evento em vez de calcular a data: a liberação roda em ciclos, então acontece pouco depois do vencimento, não no segundo exato.

Saldo internacional de cartão

A venda em euro, dólar ou libra (cartão) entra no saldo internacional, separado do saldo PIX e sempre em reais. O valor é o da venda convertido pela cotação PTAX de venda do dia em que ela foi paga, menos a taxa de 20%. O valor é liberado 30 dias depois da venda, e 10% ficam retidos por mais 90 dias e são liberados sozinhos, como na cobrança LATAM.

Esse saldo não sai por PIX: você o saca em USDT, na rede Tron (TRC20) ou BSC (BEP20), com taxa de US$ 2,00 por saque, mínimo de 20 USDT, máximo de 2.000 USDT por pedido e 5.000 USDT por dia. Você pede no painel, vê no pedido quantos USDT vai receber pela cotação do dia, e a Lezty envia o USDT para a sua carteira. Uma contestação de cartão depois do saque deixa o saldo negativo e trava novos saques até regularizar. O contrato da cobrança está em Cartão internacional.

Próximo passo

Chave PIX: você só saca para uma chave verificada, e ela tem uma regra que surpreende.

Referência: Saldo e agregados do seller no mode da API key.