Saques

Sacar via PIX

Saque imediato via PIX para qualquer chave. Mínimo de R$ 5,00. Apenas um saque pode estar em processamento por vez.

POST/withdraw/createAPI Key

Parâmetros do body

Campo	Tipo	Req.	Descrição
amount	number	Required	Valor em reais. Mínimo: R$ 5,00
pixKey	string	Required	Chave PIX de destino
pixKeyType	string	Required	`CPF`, `CNPJ`, `EMAIL`, `PHONE`, `RANDOM`
description	string	Optional	Descrição do saque
coverFee	boolean	Optional	Se `true`, o valor informado é o líquido que o destinatário recebe
verificationCode	string	Optional	Código de segurança (se transferência segura estiver ativa)
splitUser	string	Optional	E-mail para dividir o saque
splitTax	number	Optional	Porcentagem para o splitUser (0.01–100)

request

curl -X POST https://api.piv.lol/api/v1/withdraw/create \
  -H "X-API-Key: vp_sua_key" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 200,
    "pixKey": "minha@conta.com",
    "pixKeyType": "EMAIL",
    "description": "Saque semanal"
  }'

response 201

{
  "success": true,
  "message": "Saque processado com sucesso",
  "data": {
    "id": "wdr_abc456",
    "value": 20000,
    "fee": 50,
    "sent": 19950,
    "pixKey": "minha@conta.com",
    "status": "PROCESSING",
    "createdAt": "2025-05-14T11:00:00.000Z"
  }
}