Danh sách hoá đơn của đối tác

API này cho phép đối tác xem danh sách các hoá đơn chưa được thanh toán của các khách hàng thuộc quyền quản lý. Kết quả trả về bao gồm đầy đủ thông tin chi tiết như mã hoá đơn, trạng thái xử lý, tình trạng thanh toán, thời hạn đáo hạn cùng tổng giá trị hoá đơn, hỗ trợ đối tác theo dõi và quản lý hiệu quả các giao dịch tài chính.

HTTP request

• URL: /api/general/v1/partner/billing
• Method: GET
• Content Type: None
• Response Type: application/json

Tham số header

Header	Mô tả	Kiểu dữ liệu	Bắt buộc
X-Api-Key	Khóa duy nhất.	string	có

Tham Số Truy Vấn (Query Parameters)

Tên Tham Số	Kiểu Dữ Liệu	Bắt buộc	Mô Tả
page	string	không	Trang dữ liệu cần lấy, default: 0.
size	string	không	Số bản ghi của một trang, default: 10.
recvWindow	string	không	Thời gian chấp nhận (ms), default: 5000.
timestamp	string	có	Unix timestamp (milliseconds).
signature	string	có	HMAC-SHA256 signature.

Phản Hồi (Response)

Response Mẫu

{
  "status": 200,
  "message": "Success",
  "total": 7,
  "data": [
    {
      "externalUserId": "USER012",
      "billingNo": "BBT7GMW2L4X5BYFF",
      "name": "Phí duy trì Nebula Ultra 02/02/2026 - 06/02/2026 ",
      "billingStatus": "ACTIVE",
      "billingType": "MAN_FEE",
      "createdDate": "2026-02-05T08:21:12.803Z",
      "paymentDue": "2026-02-06T00:00:00.000Z",
      "lastPaymentDue": "2026-02-08T00:00:00.000Z",
      "paymentStatus": "WAIT_FOR_PAYMENT",
      "total": 255000,
      "isConfirmed": false
    },
    {
      "externalUserId": "USER011",
      "billingNo": "BLLWPRVSOKQVG3EN",
      "name": "Phí duy trì Nebula Ultra 02/02/2026 - 06/02/2026 ",
      "billingStatus": "ACTIVE",
      "billingType": "MAN_FEE",
      "createdDate": "2026-02-05T08:21:11.003Z",
      "paymentDue": "2026-02-06T00:00:00.000Z",
      "lastPaymentDue": "2026-02-08T00:00:00.000Z",
      "paymentStatus": "WAIT_FOR_PAYMENT",
      "total": 70000,
      "isConfirmed": false
    },
    {
      "externalUserId": "USER011",
      "billingNo": "BJLIJCWVJVONTFXI",
      "name": "Cập nhật tùy chỉnh Nebula Ultra",
      "billingStatus": "ACTIVE",
      "billingType": "EDIT_FEE",
      "createdDate": "2026-02-05T08:18:40.923Z",
      "paymentDue": "2026-02-05T17:00:00.000Z",
      "lastPaymentDue": "2026-02-07T17:00:00.000Z",
      "paymentStatus": "WAIT_FOR_PAYMENT",
      "total": 100000,
      "isConfirmed": true
    },
    {
      "externalUserId": "USER012",
      "billingNo": "BTYSNXAZAZSTIARQ",
      "name": "Phí duy trì Nebula Ultra 02/02/2026 - 06/02/2026 ",
      "billingStatus": "ACTIVE",
      "billingType": "MAN_FEE",
      "createdDate": "2026-02-05T03:00:41.619Z",
      "paymentDue": "2026-02-06T00:00:00.000Z",
      "lastPaymentDue": "2026-02-08T00:00:00.000Z",
      "paymentStatus": "WAIT_FOR_PAYMENT",
      "total": 255000,
      "isConfirmed": false
    },
    {
      "externalUserId": "USER011",
      "billingNo": "BJJ3LP4MM6C0LKGE",
      "name": "Cập nhật tùy chỉnh Nebula Ultra",
      "billingStatus": "ACTIVE",
      "billingType": "EDIT_FEE",
      "createdDate": "2026-02-05T02:46:47.151Z",
      "paymentDue": "2026-01-29T17:00:00.000Z",
      "lastPaymentDue": "2026-01-31T17:00:00.000Z",
      "paymentStatus": "WAIT_FOR_PAYMENT",
      "total": 100000,
      "isConfirmed": true
    },
    {
      "externalUserId": "USER0111",
      "billingNo": "BUHPHB1RKQZDU6NQ",
      "name": "Phí duy trì Nebula Ultra 26/01/2026 - 30/01/2026 ",
      "billingStatus": "ACTIVE",
      "billingType": "MAN_FEE",
      "createdDate": "2026-01-28T07:30:08.962Z",
      "paymentDue": "2026-01-30T00:00:00.000Z",
      "lastPaymentDue": "2026-02-01T00:00:00.000Z",
      "paymentStatus": "WAIT_FOR_PAYMENT",
      "total": 45000,
      "isConfirmed": false
    },
    {
      "externalUserId": "USER0111",
      "billingNo": "BUJ7HR7JOIIKJ2GW",
      "name": "Phí duy trì Nebula Ultra 29/12/2025 - 02/01/2026 ",
      "billingStatus": "ACTIVE",
      "billingType": "MAN_FEE",
      "createdDate": "2025-12-29T03:00:01.624Z",
      "paymentDue": "2026-01-02T00:00:00.000Z",
      "lastPaymentDue": "2026-01-04T00:00:00.000Z",
      "paymentStatus": "WAIT_FOR_PAYMENT",
      "total": 70000,
      "isConfirmed": false
    }
  ]
}

Chi Tiết Tham Số Response

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
status	number	Mã trạng thái HTTP.
message	string	Thông báo kết quả xử lý.
total	number	Tổng số bản ghi.
data	array (Xem chi tiết)	Dữ liệu chi tiết hoá đơn.

Cấu trúc thuộc tính data

Quay lại

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
externalUserId	string	UserId của đối tác.
billingNo	string	Mã số hóa đơn.
name	string	Tên hóa đơn.
billingStatus	string	Trạng thái của hóa đơn: - DRAFT: Nháp - ACTIVE: Đang hoạt động - PAID: Đã thanh toán - CANCELED: Đã hủy
billingType	string	Loại hóa đơn: - MAN_FEE: Phí duy trì Nebula Ultra - EDIT_FEE: Phí tuỳ chỉnh Nebula.
createdDate	string	Ngày tạo hóa đơn (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z').
paymentDue	string	Hạn thanh toán của hóa đơn (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z').
lastPaymentDue	string	Hạn thanh toán cuối cùng của hóa đơn sau khi gia hạn thêm 2 ngày (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z').
paymentStatus	string	Trạng thái thanh toán: - WAIT_FOR_PAYMENT: Chờ thanh toán - SUCCESS: Thành công - FAILED: Thất bại - PENDING: Đang xử lý - CANCELED: Đã hủy
total	number	Tổng số tiền của hóa đơn (VND).
isConfirmed	boolean	- false: Phí chưa được chốt - số tiền có thể thay đổi theo từng ngày do hệ thống tính toán lại. - true: Đã chốt phí - số tiền cuối cùng cần thanh toán, sẽ được chốt vào cuối phiên giao dịch thứ 6 hàng tuần