Lịch sử thanh toán

Trả về lịch sử các hóa đơn đã tạo.

URL

Yêu cầu ủy quyền

GET

https://api.fps.pro/invoices/history

Định dạng yêu cầupathParam

page

number

Số trang

Mặc định: 1

Định dạng phản hồidata object

id

uuid

ID hóa đơn

status

string

Trạng thái thanh toán (xem Trạng thái thanh toán)

created_at

string (ISO 8601 (RFC 3339), UTC)

Ngày tạo thanh toán

Ví dụ yêu cầu

curl --request GET 'https://api.fps.pro/invoices/history?page=1' \
  --header 'X-Client-Id: YOUR_CLIENT_ID' \
  --header 'X-Timestamp: 1720000000' \
  --header 'X-Signature: YOUR_HMAC_SHA256_SIGNATURE'

Phản hồi thành công

{
  "status": 200,
  "message": "success",
  "data": [
    {
      "id": "0a718b02-138d-495a-9661-39ca52139c07",
      "status": "paid",
      "created_at": "2026-01-05T13:30:43.000Z"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "per_page": 20,
    "last_page": 1
  }
}

Lỗi

Danh sách lỗi ủy quyền chi tiết nằm trong Ủy quyền - Lỗi

{
  "status": 422,
  "message": "Validation Error",
  "errors": [
    {
      "field": "invoice",
      "message": "The invoice must be UUID."
    }
  ]
}
{
  "status": 500,
  "message": "Internal Server Error"
}