GET /apiv2/billing/account

Tổng quan về tài khoản trả sau của bạn: hạn mức tín dụng do Netts thiết lập, hạn mức tổng thể của riêng bạn, số tiền bạn đang nợ và số tiền bạn vẫn có thể chi tiêu ngay bây giờ. Một phần của thanh toán trả sau.

URL của Endpoint

GET https://netts.io/apiv2/billing/account

Headers của yêu cầu

Tiêu đề	Bắt buộc	Mô tả
`X-API-KEY`	có	Khóa API có quyền `billing.read`
`X-Real-IP`	có	Một địa chỉ IP từ danh sách trắng của khóa

Yêu cầu không có tham số.

Ví dụ

bash

curl -s 'https://netts.io/apiv2/billing/account' \
  -H 'X-API-KEY: your-api-key' \
  -H 'X-Real-IP: 203.0.113.10'

json

{
  "success": true,
  "data": {
    "mode": "postpaid",
    "adminLimit": {
      "id": 1,
      "origin": "netts",
      "limit": { "unit": "USD", "value": "30000.000000" },
      "used": { "unit": "USD", "value": "1250.400000" },
      "available": { "unit": "USD", "value": "28749.600000" },
      "creditApplied": { "unit": "USD", "value": "0" },
      "status": "ok",
      "revision": 3,
      "editable": false
    },
    "clientLimit": {
      "id": 4,
      "origin": "client",
      "limit": { "unit": "USD", "value": "5000.000000" },
      "used": { "unit": "USD", "value": "1250.400000" },
      "available": { "unit": "USD", "value": "3749.600000" },
      "creditApplied": { "unit": "USD", "value": "0" },
      "status": "ok",
      "revision": 2,
      "editable": true
    },
    "effectiveAvailable": { "unit": "USD", "value": "3749.600000" },
    "pendingUnbilled": { "trx": "0", "count": 0 },
    "asOf": "2026-10-19T20:24:26.474237+00:00",
    "settlement": { "asset": "USDC", "network": "ethereum", "paymentTermsDays": 5 },
    "limit": { "unit": "USD", "value": "30000.000000" },
    "unpaid": { "TRX": "3778.500000", "USDC": "1250.400000" },
    "creditUsdc": "0",
    "available": "28749.600000",
    "availableTrxEquiv": "86897.437285",
    "availableUsdEquiv": "28749.600000",
    "fx": { "usdPerTrx": "0.33084276", "at": "2026-10-19T20:24:23.449930+00:00" },
    "fxStatus": "ok"
  },
  "timestamp": "2026-10-19T20:24:26+00:00"
}

Các trường phản hồi

Trường	Mô tả
`mode`	`postpaid`, hoặc `prepaid` khi tính năng thanh toán trả sau của tài khoản tạm dừng
`adminLimit`	hạn mức tín dụng do Netts thiết lập. `editable` luôn là `false`
`clientLimit`	hạn mức tổng thể của riêng bạn, hoặc `null` nếu bạn chưa thiết lập
`adminLimit.used` / `clientLimit.used`	mức hạn mức đã sử dụng
`adminLimit.available` / `clientLimit.available`	mức hạn mức còn lại
`creditApplied`	khoản tín dụng của bạn từ việc thanh toán dư đã được khấu trừ vào khoản nợ trong hạn mức này
`status`	`ok`, `limit_reached`, hoặc `unavailable` nếu hiện không thể tính toán
`effectiveAvailable`	số tiền bạn có thể chi tiêu bây giờ: giá trị nhỏ hơn trong hai giá trị `available`
`pendingUnbilled`	các đơn hàng đã được chấp nhận nhưng khoản phí vẫn đang được ghi nhận: tổng TRX và số lượng đơn hàng
`asOf`	thời điểm các số liệu được tính toán
`settlement`	phương thức bạn thanh toán hóa đơn theo hợp đồng: loại tiền tệ, mạng lưới và số ngày để thanh toán hóa đơn
`limit`, `unpaid`, `creditUsdc`, `available`	hạn mức Netts, số tiền chưa thanh toán bằng TRX và bằng loại tiền tệ trong hợp đồng của bạn, tín dụng của bạn, và phần còn lại của hạn mức Netts
`availableTrxEquiv`, `availableUsdEquiv`	`available` được quy đổi theo tỷ giá trong `fx`; `null` khi không có tỷ giá khả dụng
`fx`	tỷ giá hiện tại từ TRX sang loại tiền tệ trong hợp đồng của bạn và thời điểm lấy tỷ giá. Đây là ước tính để so sánh, không phải tỷ giá của đơn hàng trong tương lai — xem tỷ giá hối đoái được ghi nhận
`fxStatus`	`ok`, hoặc `unavailable` — khi đó các giá trị quy đổi tương đương là `null`, số tiền vẫn được hiển thị

used và available được tính toán theo cùng cách kiểm tra một đơn hàng, do đó effectiveAvailable là số tiền mà đơn hàng tiếp theo có thể sử dụng. Hạn mức sản phẩm được hiển thị trong phần hạn mức.

Lỗi

HTTP	`code`	Ý nghĩa
401	`-1`, `-2`	khóa bị thiếu hoặc không hợp lệ, hoặc IP không nằm trong danh sách trắng — phản hồi bởi cổng API gateway, xem định dạng phản hồi
403	`billing_read_required`	khóa không có quyền `billing.read`
403	`postpaid_required`	tài khoản không có thanh toán trả sau

Tất cả các mã được liệt kê trong thanh toán trả sau.

GET /apiv2/billing/account ​

URL của Endpoint ​

Headers của yêu cầu ​

Ví dụ ​

Các trường phản hồi ​

Lỗi ​

GET /apiv2/billing/account

URL của Endpoint

Headers của yêu cầu

Ví dụ

Các trường phản hồi

Lỗi