Skip to main content
Um endpoint só, POST /v1/payouts, com três destinos possíveis. O que muda é o method.

PIX

Cai como pendente e passa por aprovação. Com turbo, sai na hora.

LTC

Debita o saldo em Litecoin e envia após aprovação.

USDT

Converte BRL e entrega USDT na rede BEP20 em segundos.
Limite de 10 saques por hora, por chave de API. O turbo tem um teto próprio de 5 por hora, que corre por dentro desse.

Saque PIX

Resposta 201
string
required
pix, ltc ou usd.
number
required
Valor em reais. Mínimo de R$ 5,00, máximo de R$ 999.999,99, sempre limitado ao withdrawable da carteira.
string
required
Chave PIX, endereço LTC ou endereço USDT BEP20, conforme o method.
number
Quantidade em LTC. Obrigatório quando method é ltc.
boolean
default:"false"
Só com method: "pix". Envia o PIX na hora, sem fila de aprovação.
A chave PIX precisa estar verificada no painel antes do primeiro saque. Sem isso a resposta é 403.

Saque LTC

O cryptoAmount é obrigatório aqui e precisa ser maior que zero. O saldo debitado é o cryptoBalanceLtc da carteira, não o saldo em reais.

Saque turbo

Com "turbo": true, o PIX é enviado dentro da própria requisição. É o mesmo caminho do botão de saque turbo do painel.
Resposta 201
O turbo é irreversível. O dinheiro sai no mesmo request e não existe cancelamento depois. Quem tem a sua chave de API consegue mandar dinheiro pra fora sem passar por nenhuma aprovação. Guarde a chave como você guardaria a senha do painel.
Regras do turbo: Sem o campo turbo, nada muda: o saque continua caindo como pending para aprovação.

Saque em USDT

Converte o saldo em reais e envia USDT na rede BEP20 na hora.
Resposta 201
confirmNotCoinbase: true é obrigatório. Depósito da Coinbase não aceita USDT BEP20, e o valor enviado para lá é perdido, sem recuperação. A confirmação existe para você parar e conferir a rede do endereço antes de mandar.
Por segurança contra fraude, o saque em USDT só é liberado depois que a loja fizer o primeiro saque em PIX. Antes disso a resposta é 403.

Status

PIX comum
Aguardando aprovação.
todos
Pago.
todos
Negado. O valor volta para o saldo.
turbo e USDT
O pagamento foi enviado e a confirmação ainda não voltou. O dinheiro já saiu. Não repita o request.

Erros e o que fazer

202 e processing são os dois casos em que reenviar o request paga duas vezes. Trate ambos como sucesso provisório e reconcilie por GET /v1/payouts.

Listando

walletAddress volta sempre mascarado, com os primeiros caracteres e ***. Dado sensível (CPF, chave PIX completa) não aparece em resposta nem em log.
Cada mudança de status também dispara um webhook de saque.