电商与支付 / Stripe Payments Platform

Stripe

提供支付界面和 API、订阅及账单、退款与事件通知,也可通过 Connect 为多商户平台搭建资金流程。测试环境可模拟支付,正式收款需要符合所选服务地区的主体和业务验证要求。

在线支付订阅收费Checkout发票账单退款平台支付Webhook
01 / CAPABILITIES

开放功能

核心接口调用手册

2 个场景

覆盖测试环境 PaymentIntent 的创建与读取,以及测试余额查询。提供 form 编码、幂等处理和拒绝 live Key 的完整 Python 代码;不执行确认支付、退款或资金转移。

网站与应用收款

使用 Checkout 托管或嵌入支付页面,也可通过 Elements 自定义界面,接收支持的银行卡、钱包及本地支付方式。

接入要求需在该账号地区和业务中支持相应支付方式。正式收款前完成服务激活;客户端和服务端使用匹配环境的公钥与私钥,支付最终状态由后台确认。
创建并查询测试 PaymentIntent站内调用手册 · 参数、代码与排错

订阅与周期账单

创建产品、价格与订阅,自动生成周期发票、尝试收款并管理订阅状态、重试和取消,适合会员与 SaaS 业务。

接入要求配置客户及支付方式,按订阅状态决定开通服务;异步支付可能延后确认,不能只依据前端跳转认定订阅已付款。Billing 与基础支付分别核对费用。

退款与取消支付

在支付完成前取消适用交易,或在支付成功后发起全额、部分退款,并跟进退款状态。

接入要求退款使用可用余额且总额不能超过原交易;不同支付方式与地区的退款行为、等待时间和费用处理不同。
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

开通步骤

  1. 01

    核对地区与业务类型

    先查全球开放地区和目标产品资格,再根据真实经营主体、业务及结算条件选择账号所在地。

  2. 02

    在沙盒构建支付流程

    创建或选择独立沙盒,使用测试 Key 和官方测试支付数据,验证付款成功、失败、退款及订阅状态。

  3. 03

    完成正式验证

    在 Dashboard 提交后台要求的业务和身份资料,完成服务激活,并确认结算、公开商户信息及实际价格。

  4. 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

官方资料

以下资料用于核对本页内容。申请与使用时,请以对应接口的最新规则为准。

  1. 01
    Set up your account:验证与正式激活已核对官方资料 · 2026-10-15
  2. 02
    Global availability:Payments 开放国家与地区已核对官方资料 · 2026-10-15
  3. 03
  4. 04
  5. 05
    API keys:密钥类型、权限与环境已核对官方资料 · 2026-10-15
  6. 06
    Build a payments page:Checkout 与 Elements已核对官方资料 · 2026-10-15
  7. 07
    How subscriptions work已核对官方资料 · 2026-10-15
  8. 08
    Refund and cancel payments已核对官方资料 · 2026-10-15
  9. 09
    Connect:平台、商户能力与资金流程已核对官方资料 · 2026-10-15
  10. 10
    Connect OAuth reference已核对官方资料 · 2026-10-15
  11. 11
    Receive Stripe events in your webhook endpoint已核对官方资料 · 2026-10-15
  12. 12
    Testing:沙盒、模拟资金与测试数据已核对官方资料 · 2026-10-15
  13. 13
    Pricing and fees:支付与可选产品已核对官方资料 · 2026-10-15
  14. 14
    Dashboard 登录入口官方入口 · 细则待复核 · 2026-10-15
官方文档核对,未进行接口实测
最近核验 2026-10-15 · 查看核验说明