打开网易新闻 查看精彩图片

2024年Stripe Connect处理的支付流水超过8000亿美元,但文档整整217页。一个SaaS团队平均要踩坑47天才能跑通首次收款——这不是我编的,是Stripe官方开发者调研的数据。

更扎心的是,80%的坑出在第一步:选错账户类型。

我见过一个做健身预约平台的团队,选了Custom账户(全托管模式),结果为了通过KYC审核,专门招了2个合规专员。半年后切回Standard,人力成本直接砍掉。这就像为了装修房子,先把自己培训成建筑师。

三种账户的本质区别,一句话说清楚:你愿意让Stripe干活,还是自己来?

Standard:让客户自己管Stripe,你只管收钱

Standard:让客户自己管Stripe,你只管收钱

这是大多数SaaS该选的答案。你的客户自己注册或绑定现有Stripe账户,自己处理提现、争议、税务合规。你的代码只需要做一件事:拿到授权,然后代扣款。

OAuth流程比想象中简单。用户点击"连接Stripe",跳转到Stripe官方页面,授权后带着code回来。你的后端用这个code换stripe_user_id——这就是永久通行证,存进数据库,以后每笔交易都带它。

代码层面,关键就三步:生成URL、处理回调、保存账户ID。Stripe的SDK把OAuth的脏活都包了,你不用碰签名验证那些破事。

收款时创建PaymentIntent,transfer_data.destination指向存好的stripe_user_id,application_fee_amount填你的平台抽成。钱直接进客户账户,Stripe自动分账,你拿佣金。

打开网易新闻 查看精彩图片

争议处理、退款、1099-K税表,全归客户自己。你的支持工单里永远不会有"我的钱为什么被冻结了"这种灵魂拷问。

Express:给不想注册Stripe的卖家用

Express:给不想注册Stripe的卖家用

适合C2C市场,比如二手交易平台。卖家不用去stripe.com注册,在你的页面里填几行信息就能收款。Stripe托管后台,卖家登录看的是Stripe branded的仪表盘。

代价是你得付更高的平台费,而且功能受限。卖家做不了订阅、发票、多币种这些高级玩法。如果你的客户是正经做生意的,Express很快会成为天花板。

Custom:除非你是Square,否则别碰

Custom:除非你是Square,否则别碰

完全白标,用户看不到任何Stripe品牌。你自己搭 onboarding 流程,自己收集身份证、银行对账单,自己判断要不要通过审核。Stripe只提供API,合规责任全在你。

美国各州的 money transmitter 牌照、欧盟的PSD2、东南亚的本地化要求——这些坑的深度,够单独开一门MBA课程。Square、Shopify这种体量才玩得起。

有个判断标准:如果你的法务团队少于5人,选Custom等于自杀。

回到Standard的实现细节。OAuth回调里那个state参数不是摆设,是用来防CSRF的。把用户ID加密塞进去,回调时校验,否则攻击者可能把别人的Stripe账户绑到你的系统里。

打开网易新闻 查看精彩图片

stripe_user_id拿到后要立即验证账户状态。新创建的Standard账户可能还在pending,这时候发起支付会报错。轮询stripe.accounts.retrieve(),charges_enabled和payouts_enabled都变true再开放收款功能。

平台抽成有个坑:application_fee_amount是固定金额,不是百分比。如果你的抽成是动态的,得自己算好cent单位填进去。小数点错位一次,可能少收一个数量级。

Webhook必须配。connected_account的事件会发到你的endpoint,但格式和直接集成Stripe不一样。每个事件里有account字段,告诉你这是哪个客户的账户触发的。用这个做分账记录,别靠payment_intent_id反查。

测试环境有个trick:Stripe Connect的sandbox不支持完整的OAuth flow。得用测试账户的固定ID硬编码,或者走express onboarding的模拟流程。上线前一定要在live mode走一遍真授权,很多域名白名单、回调URL的坑只在生产环境暴露。

2025年Stripe加了新限制:Standard账户的platform fee不能超过交易金额的50%,且单笔上限2万美元。做高客单价市场的得留意,超了会硬报错。

最后说个反直觉的:Connect的集成成本,70%花在边缘场景。主流程代码两天能写完,但处理退款失败、账户解绑、争议仲裁、多币种汇率波动这些分支,能拖两个月。

有个做跨境SaaS的朋友,上线三个月后才发现:客户绑的是日本Stripe账户,收美元时汇率转换费吃掉他全部利润。后来强制要求multi-currency设置,代码里加了一层账户区域校验。

这些细节文档里都有,但埋在200页里。你不可能第一次就读完,只能在生产环境交学费。

所以最省时间的策略是:先用Standard跑通MVP,等业务量够大了再评估要不要切Express或Custom。过早优化架构,和过早优化代码一样,都是毒药。

你的SaaS现在用哪种模式?如果重来一次,你会在第一天做哪个不同的选择?