GET /apiv2/billing/payments

Các khoản thanh toán của bạn cho hóa đơn trả sau, và số tiền tín dụng còn lại từ các khoản thanh toán thừa. Bạn thanh toán bằng đơn vị tiền tệ và mạng lưới theo hợp đồng của mình — xem settlement trong tài khoản. Là một phần của thanh toán trả sau.

URL của Endpoint

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

Tiêu đề yêu cầu

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

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

Ví dụ

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"
}

Các trường

Trường	Mô tả
`network`, `txHash`	mạng lưới và giao dịch của khoản thanh toán
`fromAddress`, `toAddress`	ví của bạn và địa chỉ thanh toán của Netts
`amountUsdc`	số tiền nhận được, theo đơn vị tiền tệ trong hợp đồng của bạn
`confirmedAt`	thời điểm khoản thanh toán được ghi có, UTC
`status`	`confirmed`, hoặc `reversed` nếu khoản thanh toán đã bị hủy
`invoiceId`	hóa đơn mà khoản thanh toán được thực hiện cho, hoặc `null`
`creditUsdc`	số tiền thanh toán vượt mức hóa đơn của bạn, theo đơn vị tiền tệ trong hợp đồng; số tiền này sẽ bù trừ cho các khoản phí tiếp theo và được hiển thị là `creditApplied` trong hạn mức

Một khoản thanh toán được thực hiện cho một hóa đơn sẽ chi trả cho các khoản phí của hóa đơn đó trước, sau đó mới đến các khoản phí chưa thanh toán cũ nhất; một khoản thanh toán không có hóa đơn sẽ chi trả cho các khoản phí chưa thanh toán cũ nhất trước. Các khoản thanh toán được liệt kê từ mới nhất đến cũ nhất; tài khoản chưa có khoản thanh toán nào sẽ nhận được danh sách trống.

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 — được phản hồi bởi cổng API gateway, xem định dạng phản hồi
403	`billing_read_required`, `postpaid_required`	không có quyền, hoặc không có gói thanh toán trả sau

GET /apiv2/billing/payments ​

URL của Endpoint ​

Tiêu đề yêu cầu ​

Ví dụ ​

Các trường ​

Lỗi ​

GET /apiv2/billing/payments

URL của Endpoint

Tiêu đề yêu cầu

Ví dụ

Các trường

Lỗi