curl --request GET \
--url 'https://api.ppio.com/openapi/v1/billing/monthly/bill?startMonth=2025-10&page=1&pageSize=20' \
--header 'Authorization: Bearer <API_KEY>'
{
"data": [
{
"billId": "<string>",
"userId": "<string>",
"billingMonth": "2026-09",
"originAmountDecimal": "120.000019",
"totalAmountDecimal": "100.000019",
"voucherPayAmountDecimal": "20",
"cashPayAmountDecimal": "80",
"debtAmountDecimal": "0",
"repaidAmountDecimal": "0",
"taxAmountDecimal": "0",
"grossAmountDecimal": "100.000019",
"precisionDiffDecimal": "0.000019",
"taxAmount": "0",
"grossAmount": "10000",
"totalAmount": "1000000",
"originTotalAmount": "1200000",
"voucherPayAmount": "200000",
"cashPayAmount": "800000",
"debtAmount": "0",
"status": "paid",
"invoiceUrl": "",
"startTime": "1788192000",
"endTime": "1790783999",
"repaidAmount": "0"
}
]
}
账单管理
查询月账单明细
PPIO 管理 API 文档说明“查询月账单明细”的使用方式，帮助开发者核对月度服务使用与费用构成，了解相关请求与结果处理。
GET
/
openapi
/
v1
/
billing
/
monthly
/
bill
curl --request GET \
--url 'https://api.ppio.com/openapi/v1/billing/monthly/bill?startMonth=2025-10&page=1&pageSize=20' \
--header 'Authorization: Bearer <API_KEY>'
{
"data": [
{
"billId": "<string>",
"userId": "<string>",
"billingMonth": "2026-09",
"originAmountDecimal": "120.000019",
"totalAmountDecimal": "100.000019",
"voucherPayAmountDecimal": "20",
"cashPayAmountDecimal": "80",
"debtAmountDecimal": "0",
"repaidAmountDecimal": "0",
"taxAmountDecimal": "0",
"grossAmountDecimal": "100.000019",
"precisionDiffDecimal": "0.000019",
"taxAmount": "0",
"grossAmount": "10000",
"totalAmount": "1000000",
"originTotalAmount": "1200000",
"voucherPayAmount": "200000",
"cashPayAmount": "800000",
"debtAmount": "0",
"status": "paid",
"invoiceUrl": "",
"startTime": "1788192000",
"endTime": "1790783999",
"repaidAmount": "0"
}
]
}
请求头
string
必填
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。
查询参数
string
查询起始月份，格式为
YYYY-MM，例如 2025-10。月账单数据最早从 2025-10 开始查询。int32
页码，从
1 开始。int32
每页数量。
当前生产环境会补齐从
startMonth 起的月份，返回数量可能不会严格等于 pageSize。金额精度说明
所有 Decimal 金额字段均为十进制字符串，单位为元，最多 12 位小数，末尾去 0。 旧整数金额字段仍保留兼容，JSON 中以字符串返回，现标记为【弃用】。除taxAmount、grossAmount 的单位为分外，其余旧金额字段的单位均为 1/10000 元；Decimal 字段无需进行这些单位换算，使用前不要再次除以 10000。
响应参数
object[]
必填
月账单明细列表。
隐藏 properties
隐藏 properties
string
必填
月账单 ID。
string
必填
用户账号 ID。
string
必填
账单月份，格式为
YYYY-MM。string
必填
优惠或抵扣前的原始总额，十进制字符串，单位为元。
string
必填
月账单应付总额，十进制字符串，单位为元。
string
必填
代金券支付金额。十进制字符串，单位为元。
string
必填
现金支付金额，十进制字符串，单位为元。
string
必填
欠费金额。十进制字符串，单位为元。
string
必填
已还款金额。十进制字符串，单位为元。
string
必填
税额。十进制字符串，单位为元。
string
必填
含税总额。十进制字符串，单位为元。
string
必填
精度损失金额，等于
max(totalAmountDecimal - voucherPayAmountDecimal - cashPayAmountDecimal - debtAmountDecimal, 0)；仅 2026-07 及之后账期可能为非零，更早账期及超付情况返回 "0"。十进制字符串，单位为元。string
必填
月账单状态。取值：
pending：未出账。outed：已出账。paid：已支付。overdue：已逾期。voided：已作废。
string
必填
账单或发票下载地址。空字符串表示暂无可下载文件。
string
必填
账单周期开始时间，秒级 Unix 时间戳。
string
必填
账单周期结束时间，秒级 Unix 时间戳。
string
必填
已弃用
【弃用】月账单应付总额，单位为 1/10000 元。整数以字符串返回。请使用单位为元的
totalAmountDecimal。string
必填
已弃用
【弃用】优惠或抵扣前的原始总额，单位为 1/10000 元。整数以字符串返回。请使用单位为元的
originAmountDecimal。string
必填
已弃用
【弃用】代金券支付金额，单位为 1/10000 元。整数以字符串返回。请使用单位为元的
voucherPayAmountDecimal。string
必填
已弃用
【弃用】现金支付金额，单位为 1/10000 元。整数以字符串返回。请使用单位为元的
cashPayAmountDecimal。string
必填
已弃用
【弃用】欠费金额，单位为 1/10000 元。整数以字符串返回。请使用单位为元的
debtAmountDecimal。string
必填
已弃用
【弃用】已还款金额，单位为 1/10000 元。整数以字符串返回。请使用单位为元的
repaidAmountDecimal。string
必填
已弃用
【弃用】税额，整数以字符串返回，单位为分。请使用单位为元的
taxAmountDecimal。string
必填
已弃用
【弃用】含税总额，整数以字符串返回，单位为分。请使用单位为元的
grossAmountDecimal。curl --request GET \
--url 'https://api.ppio.com/openapi/v1/billing/monthly/bill?startMonth=2025-10&page=1&pageSize=20' \
--header 'Authorization: Bearer <API_KEY>'
{
"data": [
{
"billId": "<string>",
"userId": "<string>",
"billingMonth": "2026-09",
"originAmountDecimal": "120.000019",
"totalAmountDecimal": "100.000019",
"voucherPayAmountDecimal": "20",
"cashPayAmountDecimal": "80",
"debtAmountDecimal": "0",
"repaidAmountDecimal": "0",
"taxAmountDecimal": "0",
"grossAmountDecimal": "100.000019",
"precisionDiffDecimal": "0.000019",
"taxAmount": "0",
"grossAmount": "10000",
"totalAmount": "1000000",
"originTotalAmount": "1200000",
"voucherPayAmount": "200000",
"cashPayAmount": "800000",
"debtAmount": "0",
"status": "paid",
"invoiceUrl": "",
"startTime": "1788192000",
"endTime": "1790783999",
"repaidAmount": "0"
}
]
}
最后修改于 2026年10月21日