Saltar para o conteúdo principal

Visão Geral

Este endpoint retorna os totais atuais de saldo da organização associada ao token de gerenciamento. Ele usa a mesma referência atual de saldo da organização usada por faturamento e liquidação.

Notas

  • Os campos monetários são retornados em USD. Use balance, total_recharge e total_used para exibição; use balance_decimal, total_recharge_decimal e total_used_decimal para reconciliação exata.

Exemplo

curl -X GET "https://api.tokenlab.sh/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"

Solicitação / Resposta

Use o painel interativo OpenAPI acima para o esquema exato.

Exemplo de resposta

{
  "object": "organization_balance",
  "organization_id": "org_123",
  "balance": 42.5,
  "balance_decimal": "42.50",
  "total_recharge": 100,
  "total_recharge_decimal": "100",
  "total_used": 57.5,
  "total_used_decimal": "57.50"
}

Campos importantes

object
string
Sempre organization_balance.
organization_id
string
Organização associada ao token de gerenciamento atual.
balance
number
Saldo atual da organização em USD como JSON number para exibição.
balance_decimal
string
Saldo atual exato da organização em USD como string decimal para reconciliação.
total_recharge
number
Total de recargas bem-sucedidas da organização em USD como JSON number para exibição.
total_recharge_decimal
string
Total exato de recargas bem-sucedidas da organização em USD como string decimal para reconciliação.
total_used
number
Gasto acumulado de uso da organização em USD como JSON number para exibição.
total_used_decimal
string
Gasto acumulado exato de uso da organização em USD como string decimal para reconciliação.