billing

Hostinger B计费

Billing API 允许你浏览 Hostinger 服务目录、管理支付方式，并以编程方式控制订阅。订单通过特定资源的端点（例如域名和 VPS）下达，而不是通用的计费订单端点。

目录

• 核心概念
• 常见模式
• API 参考
• 最佳实践
• 故障排查
• 参考资料

核心概念

目录

目录包含可用的产品和定价。价格以分（整数）显示，例如 1799 表示 $17.99。在下达订单之前，使用目录来发现可用的服务及其 item_id 值。

订单

订单通过特定资源的端点（例如 POST /api/domains/v1/portfolio、POST /api/vps/v1/virtual-machines）下达，通过引用目录中的 item_id 值和支付方式来完成。不再有通用的计费订单端点。通过 API 创建的订单默认设置为自动续费。某些 credit_card 支付可能需要额外验证。

支付方式

支付方式必须通过 hPanel 添加。API 允许你列出、设置默认或删除现有的支付方式。

订阅

订阅代表有效的服务计划。你可以列出订阅并开启或关闭自动续费。

常见模式

浏览目录并下达订单

命令行（curl）：

# Get available catalog items
curl -X GET "https://developers.hostinger.com/api/billing/v1/catalog" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN" \
  -H "Content-Type: application/json"

# Filter catalog by category
curl -X GET "https://developers.hostinger.com/api/billing/v1/catalog?category=vps" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

Python SDK：

from hostinger_api import Hostinger

client = Hostinger(api_token="YOUR_API_TOKEN")

# List catalog items
catalog = client.billing.catalog.get_catalog_item_list()
for item in catalog:
    print(f"{item.name}: {item.price / 100:.2f} USD")

TypeScript SDK：

import { Hostinger } from "hostinger-api-sdk";

const client = new Hostinger({ apiToken: "YOUR_API_TOKEN" });

const catalog = await client.billing.catalog.list();
for (const item of catalog) {
  console.log(`${item.name}: ${(item.price / 100).toFixed(2)} USD`);
}

PHP SDK：

use Hostinger\Api\HostingerApi;

$client = new HostingerApi('YOUR_API_TOKEN');

$catalog = $client->billing->catalog->list();
foreach ($catalog as $item) {
    echo $item->name . ': ' . number_format($item->price / 100, 2) . " USD\n";
}

管理支付方式

# List payment methods
curl -X GET "https://developers.hostinger.com/api/billing/v1/payment-methods" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Set default payment method
curl -X POST "https://developers.hostinger.com/api/billing/v1/payment-methods/517244" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Delete a payment method
curl -X DELETE "https://developers.hostinger.com/api/billing/v1/payment-methods/517244" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

管理订阅

# List all subscriptions
curl -X GET "https://developers.hostinger.com/api/billing/v1/subscriptions" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Disable auto-renewal for a subscription
curl -X DELETE "https://developers.hostinger.com/api/billing/v1/subscriptions/12345/auto-renewal/disable" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

# Enable auto-renewal for a subscription
curl -X PATCH "https://developers.hostinger.com/api/billing/v1/subscriptions/12345/auto-renewal/enable" \
  -H "Authorization: Bearer $HOSTINGER_API_TOKEN"

API 参考

目录

方法	端点	描述
GET	/api/billing/v1/catalog	获取目录项（可按 category 和 name 过滤）

订单

已移除： 通用的 POST /api/billing/v1/orders 端点不再是 API 的一部分。请改为通过特定资源的端点下达订单 —— 域名使用 POST /api/domains/v1/portfolio，VPS 使用 POST /api/vps/v1/virtual-machines。

支付方式

方法	端点	描述
GET	/api/billing/v1/payment-methods	列出支付方式
POST	/api/billing/v1/payment-methods/{id}	设置默认支付方式
DELETE	/api/billing/v1/payment-methods/{id}	删除支付方式

订阅

方法	端点	描述
GET	/api/billing/v1/subscriptions	列出所有订阅
DELETE	/api/billing/v1/subscriptions/{id}/auto-renewal/disable	禁用自动续费
PATCH	/api/billing/v1/subscriptions/{id}/auto-renewal/enable	启用自动续费

最佳实践

定价

• 在向用户显示之前，始终获取目录价格 —— 价格以分为单位
• 除以 100 并适当格式化以进行显示

订单

• 通用的 /api/billing/v1/orders 端点已从 API 中移除
• 域名购买使用 POST /api/domains/v1/portfolio
• VPS 购买使用 POST /api/vps/v1/virtual-machines
• 优先使用非信用卡支付方式，以避免验证延迟

支付方式

• 新的支付方式必须通过 hPanel 添加，而不是通过 API
• 如果订单中未指定支付方式，将自动使用默认方式
• 删除未使用的支付方式，以保持账户整洁

订阅

• 监控订阅，以避免意外的服务中断
• 如果你打算取消，请在到期前尽早禁用自动续费

故障排查

401 Unauthorized

• 验证你的 API token 有效且未过期
• Token 权限与所属用户的权限匹配
• 检查 Authorization: Bearer <token> 请求头格式

422 Unprocessable Content

• 订单请求中的 item_id 无效 — 请对照商品目录核实
• payment_method_id 无效 — 请先列出支付方式

429 Too Many Requests

• 你已超出速率限制 — 请退避后重试
• 多次违规可能会临时封禁你的 IP

订单未处理

• credit_card 支付可能需要额外验证
• 在 hPanel 中查看订单状态
• 尝试其他支付方式

参考

• Hostinger API Documentation
• Hostinger API Changelog
• Python SDK
• TypeScript SDK
• PHP SDK
• CLI Tool