Gói dịch vụ & thanh toán
Chi tiết hoá đơn
Lấy chi tiết một hoá đơn gói dịch vụ kèm các giao dịch thanh toán và thông tin chuyển khoản
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/{id}
Yêu cầu đăng nhập. Hoá đơn của công ty khác được coi như không tồn tại (HTTP 404).
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID hoá đơn |
Response Schema
HTTP 200 - JSON Object
Trả về Invoice Object, kèm thêm:
| Trường | Kiểu | Mô tả |
|---|---|---|
payments | array | Các giao dịch đã ghi nhận cho hoá đơn (tối đa 100) |
payments[].id | int | ID giao dịch |
payments[].amount | int | Số tiền (VND) |
payments[].method | string | Hình thức: bank_transfer (chuyển khoản), manual (ghi nhận thủ công), refund (hoàn tiền) |
payments[].source | string | Nguồn ghi nhận: sepay (hệ thống tự đối soát chuyển khoản), console (nhân viên Hubport ghi nhận) |
payments[].bank_ref | string | Mã tham chiếu giao dịch ngân hàng |
payments[].received_at | int | Thời điểm nhận tiền (Unix timestamp) |
bank_info | object | Thông tin tài khoản nhận chuyển khoản của Hubport: bank_name, bank_code (tên ngắn ngân hàng dùng cho VietQR, vd MBBank), account_no, account_name, branch |
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_not_found | Hoá đơn không tồn tại hoặc không thuộc cửa hàng |
| 404 | error_saas_mode_inactive | Không phải Hubport SaaS |
Ví dụ
curl -X GET "https://api.hubport.vn/v1/platforminvoices/1201" \
-H "Authorization: <JWT>"{
"id": 1201,
"company_id": 12,
"subscription_id": 45,
"kind": "new",
"plan_id": 3,
"plan_code": "PRO",
"cycle": "month",
"number": "HP-202610-0012",
"transfer_code": "HPK7M2Q9XA",
"amount": 499000,
"amount_paid": 499000,
"amount_refunded": 0,
"amount_due": 0,
"payment_qr_url": "",
"status": "paid",
"overdue": false,
"lines": [],
"period_start": 1760403600,
"period_end": 1763082000,
"due_at": 1760922000,
"paid_at": 1760403600,
"date_created": 1760317200,
"date_modified": 1760403600,
"payments": [
{
"id": 88,
"amount": 499000,
"method": "bank_transfer",
"source": "sepay",
"bank_ref": "FT26286123456",
"received_at": 1760403600
}
],
"bank_info": {
"bank_name": "Ngân hàng ABC",
"bank_code": "MBBank",
"account_no": "0000000000",
"account_name": "TEN CHU TAI KHOAN",
"branch": "Chi nhánh XYZ"
}
}