01 / CAPABILITIES
开放功能
核心接口调用手册
2 个场景覆盖测试环境 PaymentIntent 的创建与读取,以及测试余额查询。提供 form 编码、幂等处理和拒绝 live Key 的完整 Python 代码;不执行确认支付、退款或资金转移。
网站与应用收款
使用 Checkout 托管或嵌入支付页面,也可通过 Elements 自定义界面,接收支持的银行卡、钱包及本地支付方式。
接入要求需在该账号地区和业务中支持相应支付方式。正式收款前完成服务激活;客户端和服务端使用匹配环境的公钥与私钥,支付最终状态由后台确认。
创建并查询测试 PaymentIntent站内调用手册 · 参数、代码与排错→订阅与周期账单
创建产品、价格与订阅,自动生成周期发票、尝试收款并管理订阅状态、重试和取消,适合会员与 SaaS 业务。
接入要求配置客户及支付方式,按订阅状态决定开通服务;异步支付可能延后确认,不能只依据前端跳转认定订阅已付款。Billing 与基础支付分别核对费用。
退款与取消支付
在支付完成前取消适用交易,或在支付成功后发起全额、部分退款,并跟进退款状态。
接入要求退款使用可用余额且总额不能超过原交易;不同支付方式与地区的退款行为、等待时间和费用处理不同。
多商户平台与资金流程
通过 Connect 管理平台下的连接账号,设计商户入驻、能力申请和平台收款、分配及付款流程。
接入要求平台和连接账号均需满足适用地区、验证与能力要求;按自己的业务模式选择收款责任和资金路径,普通收款账号不自动具备完整平台能力。
支付事件与自动化
通过 Webhook 接收付款、争议、退款或订阅事件,让自己的订单、会员和财务系统跟随状态变化。
接入要求注册公网 HTTPS 端点并校验签名,处理重复或延迟事件。可用 Stripe CLI 在本地联调;测试和正式环境的端点、密钥与资源应分别配置。
02 / REQUIREMENTS
接入条件
- 适用主体
- 出海开发者、SaaS 团队、电商商户、平台与市场开发者
- 接入方式
- 服务端使用 Secret API Key 或按最小权限配置的 Restricted Key / 前端仅使用可公开的 Publishable Key 配合支付界面 / Connect 的适用路线可使用 OAuth 授权;Webhook 使用独立端点签名校验
- 申请概况
- 正式收款需支持地区主体与业务验证;大陆未列入 Payments 开放地区
- 正式启用 Payments 前,业务所在地必须在当前支持国家或地区中,并完成该地区要求的业务及身份验证。本次支持清单列有香港,没有列中国大陆;站点提供简体中文不等于当地可开户收款。
- 账号可能采用公司、个体或其他受支持业务类型,但个人、独资经营者及公司的可用性和证明材料依地区而异;不能仅凭 API 存在 individual 字段就认为任何个人都可开通。
- 按后台要求提供业务、产品、与业务关系及结算银行等资料;网站或应用需如实展示产品和商户联系信息。通过创建测试账号不代表已通过正式验证。
- 为自己的账号或沙盒取得匹配的 Key;仅 Publishable Key 可放前端,Secret 和 Restricted Key 需保存在后端并按需要授权。
- 使用订阅、Connect 或特定支付方式时,分别确认该账号的产品资格、地区覆盖和额外验证;第三方账号接入还需对应授权。
- 接收异步事件时准备可访问的 HTTPS 地址与签名验证,或先通过官方 CLI 本地联调;正式使用前检查安全与业务资料。
03 / GET STARTED
开通步骤
- 01
核对地区与业务类型
先查全球开放地区和目标产品资格,再根据真实经营主体、业务及结算条件选择账号所在地。
- 02
在沙盒构建支付流程
创建或选择独立沙盒,使用测试 Key 和官方测试支付数据,验证付款成功、失败、退款及订阅状态。
- 03
完成正式验证
在 Dashboard 提交后台要求的业务和身份资料,完成服务激活,并确认结算、公开商户信息及实际价格。
- 04
切换正式凭证与事件
将正式环境 Key、产品价格、Webhook 及权限分别配置,核对后台支付状态与自己的业务发货或开通流程。
04 / COSTS & LIMITS
费用、边界与测试方式
费用概况按地区、支付方式和产品分别计价,先计算交易费,再叠加所用产品。
- 标准 Payments 通常按每笔成功交易收取费用,银行卡常见结构为交易金额百分比加每笔固定金额;适用金额、币种和单价取决于账号地区。
- 国际卡、跨境交易或货币转换可能增加费用;不同本地支付方式及争议处理也有各自计费项目,不统一套用美国银行卡报价。
- Checkout 与 Payment Links 的基础收款在标准 Payments 方案中有相应包含规则;自定义域名、付款后发票等可选项可能单独计费。
- Billing、Connect、Tax 等产品需按自己的计费项另算,基础收款的无月费说明不能推广成整个平台所有功能无费用。
- 标准计费场景下,退款后通常不返还原交易处理费,部分支付方式可能产生额外退款费用;定制合同及地区差异应另行核对。
- 沙盒使用模拟交易且不转移真实资金;测试成功不能证明已取得正式交易费率或优惠。
使用范围与限制
- 全球买家可付款与商户可在哪个国家开户是不同问题;支付方式、Connect 和其他金融产品也有各自地区范围。
- 沙盒成功不代表正式账号已获准收款、付款或具备某项能力;需查看账号验证与能力状态。
- 标准计费场景退款后通常不返还原交易处理费,部分支付方式可能另收退款费用;定制合同或特定地区规则需单独核对。
- 订阅、支付与退款可能异步完成,应按可信服务端事件和对象状态提供业务服务,并处理重复事件。
- 只公开前端 Publishable Key;Restricted Key 即使权限较小也属于敏感凭证。
- 账号激活后无法直接更改业务起源国家;不同地区、产品及合同的费率不能混用。
如何进行开发测试
- 独立沙盒:使用测试 Key 和官方测试支付数据模拟付款、失败、退款与争议,不转移真实资金。
- 本地事件联调:可通过 Stripe CLI 转发测试事件;正式注册的 Webhook 端点应为公网 HTTPS 地址。
- 正式环境:完成服务激活后使用 live Key、正式资源和对应 Webhook,付款会进入实际支付与资金结算流程。
接入前再确认
- 未验证任何特定用户的开户资格;正式收款需按真实业务所在地、主体与产品完成验证。
- 价格按账号地区、支付方式和所选产品变化,本文不将某个国家费率作为统一报价。
- 未注册或激活账号、创建密钥或进行交易;沙盒能力不代表正式收款与结算已获准。
05 / OFFICIAL SOURCES
官方资料
以下资料用于核对本页内容。申请与使用时,请以对应接口的最新规则为准。
- 01
- 02
- 03
- 04
- 05
- 06
- 07
- 08
- 09
- 10
- 11
- 12
- 13
- 14
官方文档核对,未进行接口实测
最近核验 2026-10-15 · 查看核验说明