GET /apiv2/billing/usage

ค่าบริการแบบเรียกเก็บย้อนหลัง (postpaid) ของคุณ: แสดงหนึ่งรายการต่อแต่ละส่วนประกอบของคำสั่งซื้อที่คิดค่าบริการแยกกัน เรียงจากใหม่สุดไปเก่าสุด รายการจะปรากฏหลังจากบริการได้รับการจัดสรรและบันทึกแล้ว ซึ่งอาจเกิดขึ้นทีหลังการตอบกลับของคำสั่งซื้อ ใช้เพื่อตรวจสอบยอดคำสั่งซื้อให้ตรงกับยอดหนี้และใบแจ้งหนี้ ส่วนหนึ่งของการเรียกเก็บเงินแบบ postpaid

URL ของ Endpoint

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

Headers ของคำขอ

ส่วนหัว	จำเป็น	คำอธิบาย
X-API-KEY	ใช่	API key ที่มีสิทธิ์ billing.read
X-Real-IP	ใช่	ที่อยู่ IP ที่อยู่ใน whitelist ของคีย์

Query Parameters

พารามิเตอร์	จำเป็น	คำอธิบาย
from	ไม่	ค่าบริการตั้งแต่นาทีนี้ เป็นรูปแบบ ISO 8601 พร้อมระบุเขตเวลา: 2026-10-01T00:00:00Z
to	ไม่	ค่าบริการก่อนหน้านาทีนี้ รูปแบบเดียวกัน
limit	ไม่	จำนวนรายการต่อหน้า, 1–500, ค่าเริ่มต้นคือ 100
cursor	ไม่	ค่า nextCursor จากหน้าก่อนหน้า

เวลาที่ไม่มีการระบุเขตเวลาจะถูกปฏิเสธด้วย 400 invalid_request — เนื่องจากช่วงเวลาจะมีความคลุมเครือ

ตัวอย่าง

curl -s 'https://netts.io/apiv2/billing/usage?from=2026-10-01T00:00:00Z&limit=2' \
  -H 'X-API-KEY: your-api-key' \
  -H 'X-Real-IP: 203.0.113.10'

{
  "success": true,
  "data": {
    "items": [
      {
        "id": 1024,
        "orderId": "AB2EF201B582AA1",
        "productCode": "energy_1h",
        "address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "quantity": 65000,
        "unitPriceSun": "20.000000",
        "discount": null,
        "amountTrx": "1.300000",
        "amountUsdc": "0.430096",
        "usdPerTrx": "0.330842760000000000",
        "quoteId": null,
        "txHash": "5c1f0e0d3a2b4c6d8e9f0a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f",
        "fulfilledAt": "2026-10-19T10:11:42.563494+00:00",
        "status": "accrued",
        "paidTrx": "0.000000",
        "paidUsdc": "0.000000",
        "invoiceId": null,
        "reversesId": null
      }
    ],
    "nextCursor": 1023
  },
  "timestamp": "2026-10-19T20:31:10+00:00"
}

ข้อมูลค่าบริการ

ฟิลด์	คำอธิบาย
id	หมายเลขรายการค่าบริการ
orderId	คำสั่งซื้อที่รายการค่าบริการนี้สังกัดอยู่ — เป็น id เดียวกันกับที่ส่งกลับมาจาก endpoint ของคำสั่งซื้อ
productCode	energy_1h, energy_5m, bandwidth, activation หรือ aml_check
address	ที่อยู่ TRON ที่คำสั่งซื้อดำเนินการให้
quantity	หน่วย Energy หรือ Bandwidth หรือ 1 สำหรับการเปิดใช้งานหรือการตรวจสอบ
unitPriceSun	ราคาต่อหน่วยในหน่วย SUN ที่คุณถูกเรียกเก็บ ซึ่งรวมราคาเฉพาะสำหรับคุณแล้ว; เป็น null สำหรับสินค้าที่คิดราคาต่อคำสั่งซื้อ
discount	ส่วนลดแยกต่างหากสำหรับคำสั่งซื้อนี้ — type เป็น percent หรือ sun_per_unit พร้อม value ของส่วนลด — หรือ null
amountTrx, amountUsdc	ยอดเงินที่บันทึกของส่วนประกอบนี้ ในหน่วย TRX และในสกุลเงินตามสัญญาของคุณ
usdPerTrx	อัตราแลกเปลี่ยนของ TRX เทียบกับสกุลเงินตามสัญญาของคุณที่บันทึกไว้สำหรับส่วนประกอบนี้: จากการเสนอราคาหากมีการล็อกยอดไว้ มิฉะนั้นจะเป็นอัตรา ณ เวลาที่ให้บริการ
quoteId	การเสนอราคาที่คำสั่งซื้อใช้ (ถ้ามี)
txHash	ธุรกรรม TRON ของส่วนประกอบนี้ หากมี
fulfilledAt	เวลาที่ให้บริการส่วนประกอบนี้ จัดส่งสำเร็จ ในรูปแบบ UTC
status	accrued — ยังไม่ได้ออกใบแจ้งหนี้; invoiced — ออกใบแจ้งหนี้แล้ว; paid — ชำระแล้ว; reversed — ถูกยกเลิกโดยการปรับปรุงแก้ไขในภายหลัง
paidTrx, paidUsdc	จำนวนยอดค่าบริการที่ชำระแล้ว ในหน่วย TRX และในสกุลเงินตามสัญญาของคุณ
invoiceId	ใบแจ้งหนี้ ที่มีรายการนี้อยู่
reversesId	สำหรับรายการปรับปรุงแก้ไข: หมายเลขค่าบริการที่รายการนี้เข้าไปยกเลิก

คำสั่งซื้อที่มีทั้ง Energy และการเปิดใช้งานจะมีสองรายการ โดยแบ่งเป็นรายการละส่วน รายการแก้ไขจะไม่มีการแก้ไขทับรายการเดิม: แต่จะเพิ่มรายการใหม่พร้อมระบุ reversesId

การแบ่งหน้า

ส่งค่า nextCursor ไปในพารามิเตอร์ cursor เพื่อรับข้อมูลหน้าถัดไปที่เก่ากว่า ค่า nextCursor จะเป็น null ในหน้าสุดท้าย

ข้อผิดพลาด

HTTP	code	ความหมาย
400	invalid_request	พารามิเตอร์ไม่ถูกต้อง หรือ from/to ไม่ได้ระบุเขตเวลา
401	-1, -2	คีย์หายไปหรือไม่ถูกต้อง หรือ IP ไม่อยู่ใน whitelist — ตอบกลับโดย API gateway โปรดดู รูปแบบการตอบกลับ
403	billing_read_required, postpaid_required	ไม่มีสิทธิ์ หรือไม่มีการเปิดใช้งานการเรียกเก็บเงินแบบ postpaid