Gói cước & thanh toán

Mô tả

Upgrade package, lịch sử gói, đơn mua gói, thanh toán. Các API hỗ trợ:

• GET /upgradePackages: Danh sách gói (public)
• GET /upgradePackageHistories: Lịch sử gói
• GET /currentActive: Gói đang active
• PUT /{id}/convertToCurrent: Đổi gói hiện tại
• GET /upgradePackageOrders: Đơn mua gói
• GET /paymentMethods: Phương thức TT (public)
• POST /payments/generatePaymentUrl: Tạo URL thanh toán

API

---

GET /api/upgradePackages

Public. Danh sách gói nâng cấp.

GET /api/upgradePackages

result là mảng gói.

Tên trường	Kiểu dữ liệu	Mô tả
id	string	Id gói
name	string	Tên loại merchant
price	number	Giá
price_subtotal	number	Giá trước giảm
discount_value	number	Giá trị giảm
discount_type	string	Loại giảm
is_recommended	boolean	Gói gợi ý
duration_months	integer	Số tháng
sku_max	integer	Số SKU tối đa
inventory_max	integer	Số tồn tối đa
pda_max	integer	Số PDA tối đa
product_attribute_max	integer	Số thuộc tính tối đa

Response Body

{
  "code": 200,
  "message": "Success",
  "result": [
    {
      "id": "{uuid}",
      "name": "Standard",
      "price": 1000000,
      "price_subtotal": 1200000,
      "discount_value": 200000,
      "discount_type": "money",
      "is_recommended": true,
      "duration_months": 12,
      "sku_max": 1000,
      "inventory_max": 50000,
      "pda_max": 5,
      "product_attribute_max": 10
    }
  ]
}

---

GET /api/upgradePackageHistories

Lịch sử gói của merchant:

Tham số query:

Tên trường	Kiểu dữ liệu	Mô tả	Bắt buộc
page	integer	Trang	Không
size	integer	Số bản ghi trên trang	Không
sort	string	Tên trường sắp xếp	Không
order	string	asc / desc	Không

GET /api/upgradePackageHistories?page=1&size=20

Response Body

{
  "code": 200,
  "message": "Success",
  "result": [],
  "page": 1,
  "page_size": 20,
  "total": 0
}

---

GET /api/upgradePackageHistories/currentActive

Lấy gói đang active của merchant. Không có query. Dùng khi confirm quy đổi ngày dư.

GET /api/upgradePackageHistories/currentActive

Response Body

{
  "code": 200,
  "message": "Success",
  "result": {
    "id": "{uuid}",
    "upgrade_package_name": "Pro"
  }
}

---

PUT /api/upgradePackageHistories/{id}/convertToCurrent

Quy đổi remaining_day của một dòng lịch sử gói không active sang gói đang active (kéo dài expired_at). Không phải đổi loại gói / không cần nạp tiền mới. Không có body. Path id = id dòng history cần quy đổi.

PUT /api/upgradePackageHistories/\{id\}/convertToCurrent

Response Body

{
  "code": 200,
  "message": "Success",
  "result": true
}

---

GET /api/upgradePackageOrders

Đơn mua gói:

Tham số query:

Tên trường	Kiểu dữ liệu	Mô tả	Bắt buộc
page	integer	Trang	Không
size	integer	Số bản ghi trên trang	Không
sort	string	Tên trường sắp xếp	Không
order	string	asc / desc	Không

GET /api/upgradePackageOrders?page=1&size=20

Response Body

{
  "code": 200,
  "message": "Success",
  "result": [],
  "page": 1,
  "page_size": 20,
  "total": 0
}

---

GET /api/paymentMethods

Public. Phương thức thanh toán:

Tham số query:

Tên trường	Kiểu dữ liệu	Mô tả	Bắt buộc
type	integer	Loại (mặc định 1)	Không

GET /api/paymentMethods?type=1

Response Body

{
  "code": 200,
  "message": "Success",
  "result": {}
}

---

POST /api/payments/generatePaymentUrl

Tạo đơn + URL thanh toán.

Request Body

Tên trường	Kiểu dữ liệu	Mô tả	Bắt buộc
paymentMethodId	string	Id phương thức thanh toán	Có
upgradePackageId	string	Id gói nâng cấp	Có
language	string	vi	en

POST /api/payments/generatePaymentUrl

Request Body

{
  "paymentMethodId": "{uuid}",
  "upgradePackageId": "{uuid}",
  "language": "vi"
}

Response Body

{
  "code": 200,
  "message": "Success",
  "result": true
}