GET /apiv2/billing/payments

การชำระเงินของคุณสำหรับใบแจ้งหนี้แบบรายเดือน (postpaid) และเครดิตคงเหลือจากการชำระเงินเกิน คุณชำระเงินในสกุลเงินและเครือข่ายตามสัญญาของคุณ — ดู settlement ใน บัญชี ส่วนหนึ่งของ การเรียกเก็บเงินแบบรายเดือน

URL ของ Endpoint

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

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

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

คำขอนี้ไม่มีพารามิเตอร์

ตัวอย่าง

bash

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

json

{
  "success": true,
  "data": {
    "payments": [
      {
        "id": 7,
        "network": "ethereum",
        "txHash": "0x8f3c5a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5e21a",
        "fromAddress": "0x1111111111111111111111111111111111111111",
        "toAddress": "0x2222222222222222222222222222222222222222",
        "amountUsdc": "1300.000000",
        "confirmedAt": "2026-10-21T09:15:00+00:00",
        "status": "confirmed",
        "invoiceId": 12
      }
    ],
    "creditUsdc": "49.600000"
  },
  "timestamp": "2026-10-21T09:20:00+00:00"
}

ฟิลด์

ฟิลด์	คำอธิบาย
`network`, `txHash`	เครือข่ายและธุรกรรมของการชำระเงิน
`fromAddress`, `toAddress`	กระเป๋าเงินของคุณและที่อยู่สำหรับการชำระเงินของ Netts
`amountUsdc`	จำนวนเงินที่ได้รับ ในสกุลเงินตามสัญญาของคุณ
`confirmedAt`	เวลาที่การชำระเงินได้รับการบันทึกยอด, UTC
`status`	`confirmed` หรือ `reversed` หากการชำระเงินถูกยกเลิก
`invoiceId`	ใบแจ้งหนี้ที่ทำการชำระเงิน หรือ `null`
`creditUsdc`	เงินที่ชำระเกินยอดใบแจ้งหนี้ของคุณ ในสกุลเงินตามสัญญาของคุณ ซึ่งจะนำไปหักลบกับค่าใช้จ่ายถัดไปและแสดงเป็น `creditApplied` ใน ขีดจำกัด

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

ข้อผิดพลาด

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

GET /apiv2/billing/payments ​

URL ของ Endpoint ​

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

ตัวอย่าง ​

ฟิลด์ ​