curl -X GET https://carteira.nevermissapps.com/v1/balance \
-H "Authorization: Bearer SUA_API_KEY"
const response = await fetch('https://carteira.nevermissapps.com/v1/balance', {
headers: {
'Authorization': 'Bearer SUA_API_KEY'
}
});
const data = await response.json();
console.log(`Saldo disponível: R$ ${data.balance.available}`);
import requests
response = requests.get(
'https://carteira.nevermissapps.com/v1/balance',
headers={'Authorization': 'Bearer SUA_API_KEY'}
)
data = response.json()
print(f"Saldo disponível: R$ {data['balance']['available']}")
<?php
$ch = curl_init('https://carteira.nevermissapps.com/v1/balance');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer SUA_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response);
curl_close($ch);
echo "Saldo disponível: R$ " . $data->balance->available;
?>
{
"success": true,
"balance": {
"available": 150.75,
"frozen": 10.50,
"total": 161.25,
"withdrawable": 140.25,
"pendingWithdrawal": null,
"currency": "BRL",
"withdrawal": {
"minimumAmount": 10.00,
"fees": {
"turbo": 3.50,
"normal": 0.50
}
},
"breakdown": {
"legacy": {
"available": 0.00,
"frozen": 0.00
},
"woovi": {
"available": 0.00,
"frozen": 0.00,
"withdrawable": 0.00
},
"cartwave": {
"available": 150.75,
"frozen": 10.50,
"withdrawable": 140.25
}
}
}
}
{
"success": true,
"balance": {
"available": 150.75,
"frozen": 10.50,
"total": 161.25,
"withdrawable": 140.25,
"pendingWithdrawal": {
"amount": 100.00,
"status": "scheduled",
"isTurbo": false,
"requestedAt": 1706743200000
},
"currency": "BRL",
"withdrawal": {
"minimumAmount": 10.00,
"fees": {
"turbo": 3.50,
"normal": 0.50
}
},
"breakdown": {
"legacy": {
"available": 0.00,
"frozen": 0.00
},
"woovi": {
"available": 0.00,
"frozen": 0.00,
"withdrawable": 0.00
},
"cartwave": {
"available": 150.75,
"frozen": 10.50,
"withdrawable": 140.25
}
}
}
}
API - Saldo e Saques
Consultar Saldo
Retorna seu saldo disponível e informações sobre saques pendentes
GET
/
v1
/
balance
curl -X GET https://carteira.nevermissapps.com/v1/balance \
-H "Authorization: Bearer SUA_API_KEY"
const response = await fetch('https://carteira.nevermissapps.com/v1/balance', {
headers: {
'Authorization': 'Bearer SUA_API_KEY'
}
});
const data = await response.json();
console.log(`Saldo disponível: R$ ${data.balance.available}`);
import requests
response = requests.get(
'https://carteira.nevermissapps.com/v1/balance',
headers={'Authorization': 'Bearer SUA_API_KEY'}
)
data = response.json()
print(f"Saldo disponível: R$ {data['balance']['available']}")
<?php
$ch = curl_init('https://carteira.nevermissapps.com/v1/balance');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer SUA_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response);
curl_close($ch);
echo "Saldo disponível: R$ " . $data->balance->available;
?>
{
"success": true,
"balance": {
"available": 150.75,
"frozen": 10.50,
"total": 161.25,
"withdrawable": 140.25,
"pendingWithdrawal": null,
"currency": "BRL",
"withdrawal": {
"minimumAmount": 10.00,
"fees": {
"turbo": 3.50,
"normal": 0.50
}
},
"breakdown": {
"legacy": {
"available": 0.00,
"frozen": 0.00
},
"woovi": {
"available": 0.00,
"frozen": 0.00,
"withdrawable": 0.00
},
"cartwave": {
"available": 150.75,
"frozen": 10.50,
"withdrawable": 140.25
}
}
}
}
{
"success": true,
"balance": {
"available": 150.75,
"frozen": 10.50,
"total": 161.25,
"withdrawable": 140.25,
"pendingWithdrawal": {
"amount": 100.00,
"status": "scheduled",
"isTurbo": false,
"requestedAt": 1706743200000
},
"currency": "BRL",
"withdrawal": {
"minimumAmount": 10.00,
"fees": {
"turbo": 3.50,
"normal": 0.50
}
},
"breakdown": {
"legacy": {
"available": 0.00,
"frozen": 0.00
},
"woovi": {
"available": 0.00,
"frozen": 0.00,
"withdrawable": 0.00
},
"cartwave": {
"available": 150.75,
"frozen": 10.50,
"withdrawable": 140.25
}
}
}
}
Descrição
Consulta seu saldo atual disponível para saque e o valor de qualquer saque pendente.Headers
string
required
Bearer token com sua API Key
Response
boolean
Indica se a operação foi bem-sucedida
object
Informações do saldo
Show properties
Show properties
number
Saldo total disponível em R$ (soma de todos os providers)
number
Valor congelado por MEDs (contestações) em R$
number
Valor total (disponível + congelado) em R$
number
Valor disponível para saque (disponível - congelado) em R$
object
string
Moeda:
BRLobject
object
Detalhamento do saldo por provider
Show properties
Show properties
curl -X GET https://carteira.nevermissapps.com/v1/balance \
-H "Authorization: Bearer SUA_API_KEY"
const response = await fetch('https://carteira.nevermissapps.com/v1/balance', {
headers: {
'Authorization': 'Bearer SUA_API_KEY'
}
});
const data = await response.json();
console.log(`Saldo disponível: R$ ${data.balance.available}`);
import requests
response = requests.get(
'https://carteira.nevermissapps.com/v1/balance',
headers={'Authorization': 'Bearer SUA_API_KEY'}
)
data = response.json()
print(f"Saldo disponível: R$ {data['balance']['available']}")
<?php
$ch = curl_init('https://carteira.nevermissapps.com/v1/balance');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer SUA_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response);
curl_close($ch);
echo "Saldo disponível: R$ " . $data->balance->available;
?>
{
"success": true,
"balance": {
"available": 150.75,
"frozen": 10.50,
"total": 161.25,
"withdrawable": 140.25,
"pendingWithdrawal": null,
"currency": "BRL",
"withdrawal": {
"minimumAmount": 10.00,
"fees": {
"turbo": 3.50,
"normal": 0.50
}
},
"breakdown": {
"legacy": {
"available": 0.00,
"frozen": 0.00
},
"woovi": {
"available": 0.00,
"frozen": 0.00,
"withdrawable": 0.00
},
"cartwave": {
"available": 150.75,
"frozen": 10.50,
"withdrawable": 140.25
}
}
}
}
{
"success": true,
"balance": {
"available": 150.75,
"frozen": 10.50,
"total": 161.25,
"withdrawable": 140.25,
"pendingWithdrawal": {
"amount": 100.00,
"status": "scheduled",
"isTurbo": false,
"requestedAt": 1706743200000
},
"currency": "BRL",
"withdrawal": {
"minimumAmount": 10.00,
"fees": {
"turbo": 3.50,
"normal": 0.50
}
},
"breakdown": {
"legacy": {
"available": 0.00,
"frozen": 0.00
},
"woovi": {
"available": 0.00,
"frozen": 0.00,
"withdrawable": 0.00
},
"cartwave": {
"available": 150.75,
"frozen": 10.50,
"withdrawable": 140.25
}
}
}
}
Observações
Saldo disponível vs Saldo sacável: O
available representa o saldo total, mas o withdrawable é o que realmente pode ser sacado (desconta valores congelados por MEDs).Breakdown por provider: A plataforma utiliza múltiplos providers (Cartwave e Woovi). O saldo é separado por provider, mas o
available mostra o total consolidado.MEDs ativos: Se você tiver contestações (MEDs) pendentes, parte do seu saldo estará em
frozen e não disponível para saque. Consulte /v1/meds/summary para mais detalhes.Saque pendente: Se
pendingWithdrawal não for null, você já possui um saque em processamento. O valor já foi deduzido do seu saldo disponível.Quando consultar o saldo
- Antes de solicitar um saque
- Após receber notificação de pagamento aprovado
- Para exibir saldo em dashboard/painel
- Para verificar se há saque em andamento