Gói dịch vụ & thanh toán
Danh sách hoá đơn
Lấy danh sách hoá đơn gói dịch vụ của cửa hàng có phân trang và lọc theo trạng thái
Chỉ có trên Hubport SaaS
Trên bản cài đặt riêng (máy chủ riêng), endpoint trả HTTP 404 error_saas_mode_inactive.
Endpoint
GET /v1/platforminvoices
Yêu cầu đăng nhập. Chỉ trả hoá đơn của công ty đang đăng nhập, sắp xếp mới nhất trước (id giảm dần).
Query Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
page | int | Không | Số trang (Mặc định: 1) |
limit | int | Không | Số bản ghi mỗi trang (Mặc định: 20, tối đa: 100) |
status | string | Không | Lọc theo trạng thái: open, paid, void, refunded. Giá trị khác bị bỏ qua |
Response Schema
HTTP 200 - JSON Object
| Trường | Kiểu | Mô tả |
|---|---|---|
total | int | Tổng số bản ghi |
currentpage | int | Trang hiện tại |
limit | int | Số bản ghi mỗi trang |
items | array | Mảng Invoice Object |
Error Codes
| HTTP | Mã lỗi | Mô tả |
|---|---|---|
| 403 | error_company_required | Phiên đăng nhập không gắn với công ty nào |
| 404 | error_saas_mode_inactive | Không phải Hubport SaaS |
Ví dụ
curl -X GET "https://api.hubport.vn/v1/platforminvoices?status=open&page=1&limit=20" \
-H "Authorization: <JWT>"{
"total": 1,
"currentpage": 1,
"limit": 20,
"items": [
{
"id": 1201,
"company_id": 12,
"subscription_id": 0,
"kind": "new",
"plan_id": 3,
"plan_code": "PRO",
"cycle": "month",
"number": "HP-202610-0012",
"transfer_code": "HPK7M2Q9XA",
"amount": 499000,
"amount_paid": 0,
"amount_refunded": 0,
"amount_due": 499000,
"payment_qr_url": "https://qr.sepay.vn/img?acc=0000000000&bank=MBBank&amount=499000&des=HPK7M2Q9XA",
"status": "open",
"overdue": false,
"lines": [],
"period_start": 0,
"period_end": 0,
"due_at": 1760922000,
"paid_at": 0,
"date_created": 1760317200,
"date_modified": 1760317200
}
]
}