读取测试账户余额

用只读请求区分可用余额与待结算余额，验证测试环境认证。

官方资料核对 2026-10-15示例代码，未进行真实接口实测

接入准备

注册 Stripe，在 Dashboard 切换到沙盒或测试环境，取得当前环境的服务端测试 Key。
运行示例前核对密钥前缀为 sk_test_；发布正式收款另需支持地区与账户业务审核，本手册不完成激活。

准备环境变量

示例值需要替换为自己的凭证或资源 ID。代码在本机或服务端运行；密钥不应放进公开网页。

STRIPE_TEST_SECRET_KEY: Dashboard 当前测试环境的服务端 sk_test_ 密钥，禁止使用 sk_live_。

export STRIPE_TEST_SECRET_KEY='sk_test_replace_with_your_key'

以上 export 适用于 macOS / Linux 的终端，在同一终端内运行后续代码。Python 示例保存为 request.py 后执行 python3 request.py。

调用步骤

01
在当前测试环境复制 Secret key 并设置 STRIPE_TEST_SECRET_KEY。
02
运行 Python 示例，先检查 livemode=false，再按每个数组条目的 currency 解释 amount。
03
若要接入 Connect 子账户，必须另行按授权和 Stripe-Account 规则设计；本例读取认证账户本身。

调用 01

读取当前测试账户余额

GET /v1/balance 无必填查询参数。

GEThttps://api.stripe.com/v1/balance

请求头

Authorization: Bearer ${STRIPE_TEST_SECRET_KEY}
Accept: application/json

参数说明

本接口无额外业务参数；按上方要求提供凭证。

调用代码

替换示例 ID 与请求体内容后运行。

import json, os, urllib.request, urllib.error
key = os.environ["STRIPE_TEST_SECRET_KEY"]
if not key.startswith("sk_test_"):
    raise SystemExit("本示例只接受 sk_test_ 测试密钥")
req = urllib.request.Request("https://api.stripe.com/v1/balance", headers={"Authorization": "Bearer " + key})
try:
    with urllib.request.urlopen(req, timeout=30) as response:
        data = json.load(response)
except urllib.error.HTTPError as exc:
    raise SystemExit(f"HTTP {exc.code}: {exc.read().decode()}")
if data.get("livemode") is not False:
    raise SystemExit("环境核对失败")
print(json.dumps(data, indent=2))

返回示例

按官方结构整理的节选示意，非实测结果。available 为可用金额，pending 为待结算金额，均按各自币种最小单位表示；空数组或 0 可能是正常测试状态。以下为结构示意，非本站实测结果。

{
  "object": "balance",
  "available": [
    {
      "amount": 0,
      "currency": "usd"
    }
  ],
  "pending": [
    {
      "amount": 2000,
      "currency": "usd"
    }
  ],
  "livemode": false
}

常见错误与排查

HTTP 401API Key 无效或认证失败: 确认环境变量包含 Secret key，未误用 pk_test_ 公钥或已撤销密钥。
HTTP 400参数或幂等键使用不正确: 查看 error.type、error.code、error.param 与 message；同一幂等键不能用于不同参数。
HTTP 404该环境找不到资源: 确认资源 ID 与当前测试环境及账户一致。

调用注意

不能将不同 currency 金额直接相加；测试余额不是可提现的真实资金。

读取余额 Stripe 错误结构

注意事项

沙盒不会转移真实资金；本例不确认 PaymentIntent，不产生正式扣款。测试对象不能与 live 对象混用。
正式支付价格因账户地区和支付方式不同；测试成功不能证明正式收款资格、费率或结算已获批准。

核验来源

本站按官方资料整理本场景的必要调用步骤与代码，覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。

01
Stripe API Key 与测试环境隔离核验日期 2026-10-15
02
Stripe 沙盒与测试数据核验日期 2026-10-15
03
读取余额核验日期 2026-10-15
04
Stripe 错误结构核验日期 2026-10-15

Stripe的其他调用手册

创建并查询测试 PaymentIntent

← 返回Stripe的全部功能