Docs
EntrarCriar conta
Ambiente
Base URLhttps://api.sancopay.com/api/v1
Arquivo para IA
Carteira

Saldo e limites

Saldos da carteira, limites de saque, taxa de saque e o prazo de liberação dos recebimentos.

GET/balance

Carteira da conta autenticada.

Requisição
curl -X GET "https://api.sancopay.com/api/v1/balance" \  -H "Authorization: Bearer <TOKEN>"
Resposta

Conta com liberação em D+1 e limite diário.

{  "balance": {    "available": 1000,    "blocked": 0,    "current": 1000,    "withdrawable": 850  },  "limits": {    "daily": {      "count": 3,      "amount": 1200,      "count_limit": 50,      "amount_limit": 50000,      "remaining_count": 47,      "remaining_amount": 48800    },    "per_payout": 15000  },  "payout_fee": {    "model": "mixed",    "fixed": 1,    "percent": 0.5  },  "max_withdrawable": 844.78,  "settlement": {    "settlement_days": 1,    "hold_percent": 100,    "held_amount": 150,    "next_release": {      "at": "2026-11-10T03:00:00.000000Z",      "amount": 150    }  },  "updated_at": "2026-11-09T15:04:05.000000Z"}

Campos

balance.available
Saldo disponível na carteira.
balance.blocked
Reservado para saques e pré-aprovações em andamento.
balance.current
Disponível + reservado.
balance.withdrawable
O que pode sair agora: o disponível menos o que ainda está em liberação (D+N).
limits.daily
Uso e limites do dia: count e amount (usados), count_limit, amount_limit, remaining_count e remaining_amount. null sem limite diário.
limits.per_payout
Valor máximo por saque; null sem limite.
payout_fee
Taxa de saque: model (fixed, percentage ou mixed), fixed em reais e percent em % (0.5 = 0,5%). null sem taxa.
max_withdrawable
Maior saque possível agora, já descontando a taxa.
settlement
Prazo de liberação: settlement_days, hold_percent (quanto de cada recebimento fica retido; 100 = tudo), held_amount (a liberar) e next_release (data e valor da próxima liberação). null para contas sem prazo.