支付历史

返回已创建发票的历史记录。

URL

需要授权

GET

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

请求格式pathParam

page

number

页码

默认值: 1

响应格式data object

id

uuid

发票 ID

status

string

支付状态（见支付状态）

created_at

string (ISO 8601 (RFC 3339), UTC)

支付创建日期

请求示例

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'

成功响应

{
  "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
  }
}

错误

详细的授权错误列表位于 授权 - 错误

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