PAYATHON 2026

Google Cloud API 能否为 billing account 添加 payment method？

支付老李

结论

Google Cloud 目前没有公开的 Cloud Billing API 用于向 billing account 添加信用卡、银行卡或其他 payment method。

billingAccounts.create 只能创建结算账号并设置基本配置。payment method 属于 Google Payments 管理的敏感支付信息，必须由具备相应权限的用户通过 Google Cloud Console 或 Google Payments 页面添加。服务账号、Terraform 和 Cloud Billing REST API 都无法直接完成这项操作。

为什么 Cloud Billing API 无法添加付款方式

Cloud Billing API 可以管理以下资源和关系：

  • 创建、查询和更新 billing account
  • 将项目关联到 billing account
  • 查询项目当前使用的 billing account
  • 管理预算、通知和部分结算配置

payment method 不是 BillingAccount 资源的字段。API 返回的 billing account 信息不会包含完整的银行卡资料，也没有下面这样的公开接口：

POST https://cloudbilling.googleapis.com/v1/billingAccounts/{billingAccount}/paymentMethods

这个端点并不存在，不要自行构造此类请求。

付款方式由关联的 Google Payments profile 管理，其中涉及银行卡号、银行账户、身份验证、地区合规和风控流程。Google 没有为这些操作提供通用的 Cloud Billing 自动化接口。

正确的处理方式

自助结算账号

使用信用卡或银行账户付款的自助结算账号，需要由有权访问付款资料的用户手动添加 payment method。控制台界面可能会随时间调整，通常可以按照以下路径操作：

  1. 打开 Google Cloud Console。
  2. 进入 Billing。
  3. 选择目标 billing account。
  4. 打开 Payment overview、Payment settings 或 Payment methods。
  5. 进入关联的 Google Payments profile。
  6. 添加并验证信用卡、银行卡或当地支持的其他付款方式。

拥有 Google Cloud billing account 的管理权限，并不一定能修改 Google Payments profile。操作者还需要相应付款资料的管理权限。

月结或发票结算账号

如果 billing account 使用 invoiced billing，通常无需添加信用卡，而是根据合同和发票信息结算。需要调整付款安排、银行信息或结算主体时，应联系 Google Cloud Billing Support、销售代表或账号团队。

API 仍然可以完成哪些操作

payment method 配置完成后，可以通过 API 自动关联项目和 billing account。

查询 billing account：

curl \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://cloudbilling.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID"

将项目关联到指定的 billing account：

curl -X PUT \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{
    "billingAccountName": "billingAccounts/BILLING_ACCOUNT_ID"
  }' \
  "https://cloudbilling.googleapis.com/v1/projects/PROJECT_ID/billingInfo"

也可以使用 gcloud：

gcloud billing projects link PROJECT_ID \
  --billing-account=BILLING_ACCOUNT_ID

这些操作只负责设置项目使用哪个 billing account，不能创建、验证或修改 payment method。

推荐的自动化流程

如果需要自动开通多个项目，可以先由人工完成支付配置，再用 API 配置资源：

  1. 由财务或结算管理员创建并验证 Google Payments profile。
  2. 为 billing account 配置有效的 payment method，或完成发票结算审批。
  3. 为自动化服务账号授予必要的 Cloud Billing IAM 权限。
  4. 使用 Cloud Billing API 或 gcloud 创建、查询并关联项目。
  5. 配置预算和费用告警，防止新项目产生未受控费用。

注意事项

  • 不要将信用卡号、CVV 或银行账户凭据写入脚本、Terraform、Secret Manager 或 API 请求。
  • Billing Account Administrator、Billing Account User 等 Cloud Billing 角色，不一定同时拥有 Google Payments profile 的管理权限。
  • billing account 已经创建，不代表它已配置可用的付款方式，也不代表它能够正常产生费用。
  • 可用的 payment method 类型取决于国家或地区、账号类型、币种和 Google 的验证要求。
  • 如果控制台没有添加付款方式的入口，常见原因包括权限不足、账号使用发票结算、付款资料由组织管理，或需要 Google 支持团队介入。

这项需求无法完全通过公开 API 实现。payment method 必须在 Google Payments 或 Google Cloud 的结算界面中配置，完成后才能使用 Cloud Billing API 自动处理其他结算账号配置和项目关联工作。

备注：内容仅供参考。