Stripe API logo

Stripe API

Stripe API

面向开发者的在线支付与商业基础设施 API,支持卡支付、订阅、Connect 多商户分账。

访问站点 ↗健康巡检 9 小时前
适合什么时候用

开发者文档质量极高

先注意什么

费率按交易抽成,小金额订单成本相对较高

第一步先查

在 stripe.com 创建账户,进入 Dashboard 取得 test/live secret key。所有请求通过 HTTPS 用 Bearer Authorization 头携带 secret key 认证。先在 test mode 调通流程,再切到 live mode。

认证
api_key
CORS
不支持
HTTPS
注册
需要
延迟
333 ms
协议
REST
计费
paid

可用率 · 30 天窗口

巡检: 1可用率: 100%平均延迟: 333ms
01

关于这个 API

Stripe 是面向互联网业务的支付与商业基础设施。它把卡受理、订阅计费、争议管理、合规、Connect 多方分账等模块封装成统一的 REST API,让开发者不用直接对接每家银行或支付网络,就能从零开始接收线上付款。

Stripe 的差异化在于开发者体验:稳定的 API 版本控制、覆盖主流语言的 SDK、详尽到逐字段的文档、以及完整的 test mode(含数十种用于模拟拒付、3DS、争议等场景的测试卡)。其周边产品(Connect、Billing、Tax、Identity、Issuing)共享同一 API 模型,让一个应用可以从单店支付逐步扩展到 marketplace 或全球业务。

费用按每笔交易抽成,无月费但小额支付成本较高;部分高级模块(如发卡、银行账户开户)目前仅在限定国家开放。建议先在 Stripe 文档的 supported countries 页面确认目标市场。

02

你可以做什么

  • 1集成卡支付与钱包结账
  • 2搭建订阅与计量计费
  • 3运营多商户 marketplace 分账
  • 4处理退款、争议与对账
  • 5为应用嵌入 Stripe Checkout / Elements
03

优劣对比

优点

  • 开发者文档质量极高
  • SDK 覆盖主流后端语言
  • 幂等键机制让重试安全
  • 强大的测试模式 + 真实卡号模拟

注意事项

  • 费率按交易抽成,小金额订单成本相对较高
  • 部分国家与币种受限,需查阅 supported countries 页面
  • 某些高级功能(如 Issuing、Atlas)按地区开放
04

示例请求

通用模板 — 实际 endpoint 请查阅文档替换 <endpoint>。
curl https://stripe.com/<endpoint> \
  -H "Authorization: Bearer $API_KEY"
# Some providers use X-Api-Key instead — verify in the docs.
05

快速开始

在 stripe.com 创建账户,进入 Dashboard 取得 test/live secret key。所有请求通过 HTTPS 用 Bearer Authorization 头携带 secret key 认证。先在 test mode 调通流程,再切到 live mode。

06

常见问题

使用 Stripe API 需要付费吗?+

调用 API 本身免费;只有真实交易发生时按比例收取手续费,标准费率约 2.9% + 0.30 美元/笔,跨境与币种转换另有加价。

如何安全保管 secret key?+

secret key 仅放在服务端环境变量,不要写入前端或公开仓库。Stripe 提供 restricted key 用于限制单一权限。

Stripe 支持哪些国家?+

受理货币与商户结算国家不完全相同,请查阅 stripe.com/global 页面确认目标市场。

是否提供测试环境?+

提供完整 test mode,几十种测试卡号可触发拒付、3DS、争议等场景。test 与 live key 完全隔离。

API 有版本控制吗?+

是的,每个请求绑定账户当前的 API 版本;可在 Dashboard 升级或在请求头 Stripe-Version 中显式指定。

07

技术细节

CORS: NoHTTPS: Yes注册: Yes开源: No
认证方式
api_key
计费
paid
协议
REST
SDK
python, javascript, typescript, ruby, java, go, php, csharp
响应时间
333 ms
上次巡检
2026/5/12 07:38:28
08

接口端点

从 OpenAPI spec 自动解析。显示 12 / 442 个未弃用端点。

GET
/v1/account
expand:query
POST
/v1/account_links
GET
/v1/accounts
created:queryending_before:queryexpand:querylimit:querystarting_after:query
POST
/v1/accounts
DELETE
/v1/accounts/{account}
account:path*
GET
/v1/accounts/{account}
account:path*expand:query
POST
/v1/accounts/{account}
account:path*
POST
/v1/accounts/{account}/bank_accounts
account:path*
DELETE
/v1/accounts/{account}/bank_accounts/{id}
account:path*id:path*
GET
/v1/accounts/{account}/bank_accounts/{id}
account:path*expand:queryid:path*
POST
/v1/accounts/{account}/bank_accounts/{id}
account:path*id:path*
GET
/v1/accounts/{account}/capabilities
account:path*expand:query

另有 430 个端点未显示,详见 OpenAPI spec。

09

标签

10

可以替代的选择

不同公司、解决相似问题的备选。按分类、认证、计费档位与标签重合度匹配。