Stripe集成：Customer资金扣划、奖励发放及账户配置咨询

一、双资源映射的用户体系搭建 #

不需要在Customer和Connect Account之间二选一，两类资源分别对应入金、出金场景，直接和你业务系统的唯一用户ID做关联绑定即可，具体设计：

• 每个真实平台用户（含普通投资者、P0项目创建方）在业务库生成唯一user_id，同时关联两类Stripe资源：
  • 入金链路：为每个user_id创建1个Stripe Customer对象，存储用户的扣款支付方式（银行卡、信用卡等），创建Checkout Session时直接绑定对应Customer ID，完成投资扣款，资金先归集到平台主Stripe账户。
  • 出金链路：为所有需要接收奖励/分成的user_id创建Custom类型Stripe Connect Account，专门处理奖励发放的资金划转。

注意不要混淆Transfer和Payout的能力边界：Payout是Connect账户将自身余额提现到绑定外部银行卡的原生操作，给用户发奖励不需要用户手动发起提现，直接调用Transfer接口把对应奖励金额从平台主账户划转至目标用户的Connect Account余额，提前在Stripe后台开启Connect账户自动Payout规则，资金到账Connect Account后会自动打款到用户绑定的收款卡，全程用户无感知。

完整业务流程节点：

1. 投资入金：用户发起投资申请→跳转绑定对应用户Customer ID的Checkout Session→用户完成支付校验→资金进入平台主账户，业务库记录用户投资持仓数据。
2. 奖励发放：业务系统触发奖励规则（投资返现、P0项目分成、活动奖励等）→调用Transfer接口将对应奖励金额划转至目标用户的Connect Account→Connect账户触发自动Payout→资金打至用户绑定的收款卡，Webhook回调更新业务库奖励发放状态。

二、Custom Connect Account的配置要求 #

不支持仅绑定卡号就完成Custom类型账户配置。
Custom Connect Account属于Stripe白标托管账户，必须满足展业属地的KYC合规要求才能解锁资金转出权限：

• 面向中国大陆用户的场景，必须收集的核心信息包括：用户真实姓名、身份证号、一类储蓄卡卡号、开户行全称，部分额度场景需要补充身份证正反面材料完成实名认证，所有必填字段未补全前，账户会被限制Payout权限，无法接收Transfer划转也无法完成打款。
• 面向其他国家/地区用户的场景，必填KYC字段可以在Stripe后台Custom账户合规配置页直接查看，按照字段要求收集即可。

实操优化：可以把信息收集步骤拆分，用户首次入金时仅需创建Customer对象绑定扣款卡，不需要填写收款相关的KYC信息；等用户首次产生待发放的奖励/分成时，再引导用户补充收款卡信息和必填KYC字段完成Connect账户激活，降低用户首次操作门槛。

三、落地避坑要点 #

• 所有交易状态以Webhook回调为准：不要依赖前端页面跳转判断支付、打款结果，必须监听checkout.session.completed、transfer.created、payout.paid、payout.failed等核心事件，每笔交易绑定业务系统唯一流水号，做好资金对账。
• 扣款卡和收款卡做隔离设计：用户入金的扣款卡存储在Customer对象下，收奖励的收款卡存储在Connect Account下，不需要强制两张卡一致，符合普通用户的使用习惯。
• 灵活配置Payout规则：默认自动Payout周期为T+2，也可以根据业务需求改成手动触发Payout，比如用户奖励满100元再统一打款，降低小额打款产生的手续费成本。

内容的提问来源于stack exchange，提问作者Kirill Kaznacheev