Skip to main content
Os créditos de mensagem custeiam o envio via WhatsApp Cloud API. Use este endpoint para verificar o saldo disponível antes de realizar disparos.

Endpoint

GET /v1/message-credits/wallet
Escopo necessário: read:message_credits

Exemplo de requisição

curl "https://api.socialsell.ai/v1/message-credits/wallet" \
  -H "Authorization: Bearer sk_live_..."

Exemplo de resposta

{
  "data": {
    "balance_cents": 50000,
    "reserved_cents": 1200,
    "available_cents": 48800,
    "currency": "BRL",
    "auto_topup": {
      "enabled": true,
      "thresholdCents": 10000,
      "amountCents": 50000
    },
    "status": "active"
  }
}

Campos da resposta

CampoTipoDescrição
balance_centsintegerSaldo total em centavos
reserved_centsintegerValor reservado para envios em andamento
available_centsintegerSaldo disponível (balance - reserved)
currencystringMoeda (BRL)
auto_topupobjectConfiguração de recarga automática
statusstringStatus da carteira (active, suspended)
Sempre use available_cents para verificar se há saldo suficiente — balance_cents pode incluir valores já comprometidos com disparos em andamento.