Manajemen

Lihat saldo organisasi

Mengembalikan total saldo organisasi saat ini untuk management token.

GEThttps://api.tokenlab.sh/v1/management/balance

Ikhtisar

Endpoint ini mengembalikan total saldo saat ini untuk organisasi yang terkait dengan management token. Endpoint ini memakai sumber kebenaran saldo organisasi yang sama dengan billing dan settlement.

Catatan

  • Kolom moneter hanya mendukung USD.

  • Field moneter dikembalikan dalam USD. Gunakan balance, total_recharge, dan total_used untuk tampilan; gunakan balance_decimal, total_recharge_decimal, dan total_used_decimal untuk rekonsiliasi akurat.

Contoh

Permintaan

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

Permintaan / Respons

Halaman ini menyediakan skema OpenAPI dan contoh permintaan yang dapat disalin. Kirim permintaan manajemen dari terminal atau klien menggunakan Management Token; pengiriman langsung tidak tersedia di halaman ini.

Contoh respons

Respons

200 OK
{
  "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"
}

Field penting

objectstring
Selalu organization_balance.
organization_idstring
Organisasi yang terkait dengan management token saat ini.
balancenumber
Saldo organisasi saat ini dalam USD sebagai JSON number untuk tampilan.
balance_decimalstring
Saldo organisasi saat ini yang akurat dalam USD sebagai string desimal untuk rekonsiliasi.
total_rechargenumber
Total top-up organisasi yang berhasil dalam USD sebagai JSON number untuk tampilan.
total_recharge_decimalstring
Total top-up organisasi yang berhasil secara akurat dalam USD sebagai string desimal untuk rekonsiliasi.
total_usednumber
Akumulasi pengeluaran penggunaan organisasi dalam USD sebagai JSON number untuk tampilan.
total_used_decimalstring
Akumulasi pengeluaran penggunaan organisasi yang akurat dalam USD sebagai string desimal untuk rekonsiliasi.

Otorisasi

ManagementTokenAuth
AuthorizationBearer <token>

Autentikasi token manajemen. Buat atau kelola Management Token di Dashboard > API > Management Tokens.

Lokasi: header

Respons

application/json

application/json

application/json

application/json