GET /apiv2/billing/invoices

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

ปลายทาง

ปลายทาง	ส่งคืน
`GET /apiv2/billing/invoices`	ใบแจ้งหนี้ทั้งหมด เรียงตามรอบบิลล่าสุดก่อน
`GET /apiv2/billing/invoices/{id}`	ใบแจ้งหนี้หนึ่งใบพร้อมรายการค่าธรรมเนียม

ส่วนหัวของคำขอ

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

ตัวอย่าง

bash

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

json

{
  "success": true,
  "data": {
    "id": 12,
    "periodStart": "2026-10-12T00:00:00+00:00",
    "periodEnd": "2026-10-19T00:00:00+00:00",
    "totalTrx": "3778.500000",
    "totalUsdc": "1250.400000",
    "paidUsdc": "0.000000",
    "status": "issued",
    "issuedAt": "2026-10-19T00:10:00+00:00",
    "dueAt": "2026-10-24T00:10:00+00:00",
    "charges": [
      {
        "id": 1024,
        "orderId": "AB2EF201B582AA1",
        "productCode": "energy_1h",
        "amountTrx": "1.300000",
        "amountUsdc": "0.430096",
        "status": "invoiced"
      }
    ]
  },
  "timestamp": "2026-10-19T20:31:10+00:00"
}

แต่ละรายการค่าธรรมเนียมมีฟิลด์เดียวกันกับใน การใช้งาน โดยตัวอย่างจะแสดงเพียงบางส่วนเท่านั้น

ข้อมูลใบแจ้งหนี้

ฟิลด์	คำอธิบาย
`id`	หมายเลขใบแจ้งหนี้
`periodStart`, `periodEnd`	รอบการเรียกเก็บเงินที่ใบแจ้งหนี้ครอบคลุม ในรูปแบบ UTC
`totalTrx`, `totalUsdc`	ยอดรวมของใบแจ้งหนี้ ในสกุลเงิน TRX และในสกุลเงินตามสัญญาของคุณ
`paidUsdc`	จำนวนเงินที่ชำระแล้ว ในสกุลเงินตามสัญญาของคุณ
`status`	`issued`, `delivered`, `partially_paid`, `paid` หรือ `void`
`issuedAt`	วันและเวลาที่ออกใบแจ้งหนี้
`dueAt`	วันที่ครบกำหนดชำระ
`charges`	มีเฉพาะใน `/invoices/{id}`: รายการค่าธรรมเนียมของใบแจ้งหนี้

ปลายทางสำหรับรายการจะส่งคืนฟิลด์เดียวกันโดยไม่มี charges บัญชีที่ยังไม่มีใบแจ้งหนี้จะได้รับรายการว่างเปล่า

ข้อผิดพลาด

HTTP	`code`	ความหมาย
401	`-1`, `-2`	คีย์หายไปหรือไม่ถูกต้อง หรือ IP ไม่ได้อยู่ในรายการที่อนุญาต — ตอบกลับโดยเกตเวย์ API ดูที่ รูปแบบการตอบกลับ
403	`billing_read_required`, `postpaid_required`	ไม่มีสิทธิ์ หรือไม่มีการเรียกเก็บเงินแบบรายเดือน
404	`not_found`	ไม่พบใบแจ้งหนี้ดังกล่าวในบัญชีของคุณ

GET /apiv2/billing/invoices ​

ปลายทาง ​

ส่วนหัวของคำขอ ​

ตัวอย่าง ​

ข้อมูลใบแจ้งหนี้ ​